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PREFACE 


This manual is intended for system administrators and operators 
of an OS/32 Multi-Terminal Monitor (MTM) System. It provides 
step-by-step procedures for imstalling and operating an MTM 
system that is tailored to meet the needs of a particular 
organization. 


Chapter 1 describes MTM and lists the system requirements’) and 
basic steps in configuring an MT system. It also lists the 
recommended OS/32 system generation (sysgen) options that improve 
MTM efficiency. Chapter 2 outlines the MTM sysgen procedure anda 
defines the MTM sysgen procedure options. Chapter 3 describes 
building, loading and starting the Authorized User Utility, and 
lists the Authorized User Utility commands. Chapter 4 discusses 
the OS/32 Accounting Facility option. Chapter 5 describes’ the 
operating procedures needed to load, start and control the MT. 
Chapter 6 introduces the load-leveling executive (LLE) software 
and describes its use in enhancing MTM performance in a Model 


3200MPS System multiprocessing environment. Appendix A 
summarizes the MTM sysgen options. Appendix B summarizes the 
Authorized User Utility commands. Appendix C lists the 
Authorized User Utility messages. Appendix D contains the 
accounting transaction file (ATF) record formats. Appendix E 


lists the MTM operator commands. 


Revision 03 of this manual introduces LLE software and its 
associated commands. Chapter 6 describes the following commands 
to control and optimize LLE: 


e® .MTM LLE CPU 

@ .MTM LLE DISPLAY 

@ .MTM LLE ELIGIBILITY 
@ .MTM LLE LPU 

@ .MTM LLE OFF 

@ .MTM LLE ON 
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Revision 03 includes the priority scheduling mechanism (PSM) and 
the description of options that enable the system operator to 
control the PSM. 


This manual is intended for use with the 0OS/32 RO0O7.2 software 
release and higher. 


For information on the contents of all Perkin-Elmer 32-bit 
manuals, see the 32-Bit Systems User Documentation Summary. 
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CHAPTER 1 
GENERAL DESCRIPTION 


1.1 INTRODUCTION 


The OS/32 Multi-Terminal Monitor (MTM) is an interactive 
multi-terminal, time-sharing system that executes as an executive 
task (e-task) in an OS/32 environment. MIM can be loaded, 
started and cancelled without disrupting the execution of other 
tasks running concurrently under OS/32. All tasks loaded and 
started from a user terminal execute as subtasks of MTM. Figure 


1-1 shows the relationship of application tasks to OS/32 and MIM 
in a typical MTM system environment. 


6429 
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APPLICATION 
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APPLICATION 
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FILE SYSTEM 
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Figure 1-1 MTM System Environment 
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1.2 MULTI-TERMINAL MONITOR (MTM) SYSTEM REQUIREMENTS 

The minimum hardware and software requirements for configuring an 
MTM system are: 

@e OS/32 RO7.2 software release 

@ Perkin-Elmer Series 3200 Processor 


@ Memory access controller (MAC) or memory address translator 
(MAT), aS appropriate 


@e Universal clock (UCLOCK) module 
@e Power fail/auto-restart option 
@e Console device 


@ Relocating (REL) loader, bootloader or loader storage unit 
(LSU) to load the operating system 


@e 256kb of memory (288kb or greater is recommended ) 
@e Disk device 


@ ASCII terminal device 


1.3 CONFIGURING A MULTI-TERMINAL MONITOR (MTM) SYSTEM 

The following procedure is used to configure an MTM system. 

l. Perform an OS/32 system generation (sysgen). See the 0S/32 
System Generation/32 (Sysgen/32) Reference Manual. 


2. Unpack the MTM software. See the MTM packaging document for 
instructions. 


3. Perform an MTM sysgen, modifying the MTM sysgen options to 
reflect installation requirements. See Chapter 2 for more 
information. 


4. Build an authorized user file (AUF) using the Authorized User 
Utility described in Chapter 3. 


5. Load and start MTM. See Chapter 5 for more information. 


Le? 48-023 FOO ROS 


1.4 OS/32 SYSTEM GENERATION (SYSGEN) OPTIONS 


When generating an operating system for an MTM system, select the 
following sysgen options to improve the overall efficiency and 
effectiveness of the system. 


@e Secondary directory support - adds a memory-resident directory 
to the system to reduce file search time. 


e@e Segmentation support - allows the task image to be segmented 
into a private image area containing impure code and a shared 
image area containing pure code. During multiple simultaneous 
executions of the task, a copy of the private image is loaded 
into memory for each user, but only one copy of the shared 
image is loaded. 


@ Roll support - ensures that MTM can service a number of tasks 
in a limited amount of memory space. 


e Spool support - provides input and output spooling 
capabilities to the MTM user. . 


@e Accounting support - is required if the OS/32 Accounting 
Facility is to be used with MTM (see Chapter 4). 

1.5 FILE DESCRIPTORS 

Many of the command formats in this manual require the user to 


enter a file descriptor (fd). File descriptors are entered in 
the following format. 


Format: 


Looe | Jeesenamd Ca |, eel 


Parameters: 


voln: is a l- to 4-character disk volume name. The 
first character must be alphabetic and the 
remaining alphanumeric. If voln: is not 


specified, the default volume specified by the 
VOLUME command is used. 
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dev: 


filename 


ext 


actno 


file class 


is a l- to 4-character device name. The first 
character must be alphabetic and the remaining 
alphanumeric. . 


is a l- to 8-character name of a file. The 


first character must be alphabetic and the 
remaining alphanumeric. If a filename is 


specified when a device mnemonic is specified 
as voln:, the filename is ignored. 


is the name of the extension and consists of 
from 1- to 3-alphanumeric characters. For 
some commands, extensions are appended by 
default. If the period is omitted, the 
default is blanks. 


is a decimal number ranging from 0 to _ 65,535 
that specifies the account number associated 
with the file. Account numbers 1 through 
65,535 are used by MTM. Account number 255 is 
a restricted account. MTM uses account 255 
for the AUF. Account number O is used _ for 
system files and is the default for all 
operator commands entered from the system 
console. Tasks must have account privileges 
to specify an account number in this field. 


is the class name of the file and consists of 
one character. The class names are: 

e /P for private file 

e /G for group file 

e /S for system file 

The file class can be specified by a terminal 
user or the system operator. If the system 


operator specifies /P, /G or /S, the operation 
is performed to account O only. 
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CHAPTER 2 
‘MULTI-TERMINAL MONITOR (MTM) SYSTEM GENERATION (SYSGEN) 


2.1 INTRODUCTION 


This chapter describes MTM sysgen procedures and options 
available for configuring an MTM system. 


The MTM task consists of two modules: 


e@ MTMMAIN 

@ MTMSGN 

MTMMAIN is a fixed length object file containing the executable 
code for MTM. 


MTMSGN is a source file containing the MTM sysgen options. These 
options can be modified to meet installation requirements. 


The procedure for performing an MTM sysgen is as follows: 

e Select the MIM sysgen options that pertain to the 
installation. . 

e@ Use the command substitution system (CSS) command file 


(MTMSGN.CSS) to build the MTM task. 


The following sections describe the MTM sysgen procedure in 
detail. 


2.2 SELECTING MULTI-TERMINAL MONITOR (MTM) SYSTEM GENERATION 
(SYSGEN) OPTIONS 


MTMSGN is a source module that contains the information necessary 
to configure an MTM system that meets the requirements of a 


particular installation. For example, one data field in this 
file tells MTM how many users can be signed on to the _ system 
concurrently. Another data field tells MTM how many command 


buffers to reserve in memory. See Section 2.4 for a_ complete 
description of the sysgen options contained in this file. 
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Perkin-Elmer supplies a standard MIM sysgen parameter file 
(MTMPARMS.MAC) with the MTM package. This file contains the 
following code: 


* *MTM . SGN 

SPACE 2 

VERS ION 

SPACE 2 
SGN.ACT EQU 0 NO ACCOUNTING SUPPORT 
SGN.SCHR EQU 1 O=NONE / 1=DYNAMIC / 2=PSM 
SGN.ROLL EQU 1 FORCE TASK ROLLABLE 
SGN.PRIO EQU 6 BATCH PRIORITY 
SGN.BTCP EQU 0 CANCEL BATCH JOB ON PAUSE 
SGN.SPL EQU 0 NO SPL/32 SUPPORT 
SGN.$HSP EQU 0 NO $HASP INTERFACE SUPPORT 
SGN.MVOL EQU ¢’ : NO DEFAULT USER VOLUME 
SGN.VAR EQU 28 NUMBER OF VARIABLES 
SGN.@GLO EQU 15 NUMBER OF GLOBAL VARIABLES 
SGN.@INT EQU 8 NUMBER OF INTERNAL VARIABLES 
NUSERS EQU 4 NUMBER OF USERS 
NCSSLVS EQU 8 NUMBER OF CSS LEVELS 
NCSBFS EQU 10 NUMBER OF EXTRA COMMAND BUFFERS 
NCONBFS EQU 0 NUMBER OF CONSOLE BUFFERS 
NSECTS EQU NUSERS /2 NUMBER OF SECTOR BUFFERS 
NMSGS EQU NUSERS NUMBER OF MESSAGE BUFFERS 
QUESIZE EQU NUSERS SIZE OF TASK QUEUE 
CSBFSZ EQU 80 SIZE OF CSS BUFFERS 
CONBFSZ EQU 0 SIZE OF CONSOLE BUFFERS 
CDBUFSIZ EQU 3 SIZE OF SECTOR BUFFERS 
PRCLIMIT EQU 0 NO PROCESSOR TIME LIMIT 

SPACE 2 

LINKOPT 4,30 LINK OPTIONS 1I0B,LU 


In addition, MTMSGN defines values for the prompt sequence, the 
input/output (I/O) class table, user I/O limits and user 
processor time limits. See the IOTAB, UIOLIM, UPRCLIM, PRMTSEQ 
and PRMTDEV macro instructions in Section 2.4 for more 
information on the default values for these sysgen options. 


MTM sysgen options that differ from those defined by the standard 
MTM sysgen parameter file (MTMPARMS.MAC) can be selected by 
editing MTMPARMS.MAC via EDIT/32. 


In the following example, MTMPARMS.MAC is edited to permit five 
accounting classes, SPL/32 and HASP support, assignment of a user 
default volume, 25 concurrent users, larger CSS buffers and an 
increased number of I/O blocks and logical units. In addition, 
several macro calls have been appended to MTMPARMS.MAC. 
Discussion of these macro calls is deferred until their 
respective sections in this chapter. Identification name '3230-B 
System' is assigned to this MTM system. 
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**MTM .SGN 


SPACE 2 
VERSION '3230-B SYSTEM' 
SPACE 2 
SGN.ACT EQU 5 5 ACCOUNTING CLASSES 
SGN.SCHR EQU- 1 O=NONE / 1=DYNAMIC / 2=PSM 
SGN.ROLL EQU 1 FORCE TASK ROLLABLE 
SGN.PRIO EQU- 6 BATCH PRIORITY 
SGN.BTCP EQU 0 CANCEL BATCH JOB ON PAUSE 
SGN.SPL EQU 25 SPL/32 SUPPORT - 25 BUFFERS 
SGN.$HSP EQU- 1 1 $HASP INTERFACE 
SGN.MVOL EQU  C'MTM ' DEFAULT USER VOLUME - MTM 
SGN.VAR EQU 28 NUMBER OF VARIABLES 
SGN.@GLO EQU- 15 NUMBER OF GLOBAL VARIABLES 
SGN.@INT EQU- 8 NUMBER OF INTERNAL VARIABLES 
NUSERS EQU- 25 ; NUMBER OF USERS 
NCSSLVS EQU- 8 NUMBER OF CSS LEVELS 
NCSBFS EQU_ 10 NUMBER OF EXTRA COMMAND BUFFERS 
NCONBFS EQU. O NUMBER OF CONSOLE BUFFERS 
NSECTS EQU  NUSERS/2 NUMBER OF SECTOR BUFFERS 
NMSGS EQU  NUSERS NUMBER OF MESSAGE BUFFERS 
QUESIZE EQU  NUSERS SIZE OF TASK QUEUE 
CSBFSZ EQU- 120 SIZE OF CSS BUFFERS 
CONBFSZ EQU- 0 SIZE OF CONSOLE BUFFERS 
CDBUFSIZ EQU 3 SIZE OF SECTOR BUFFERS 
PRCLIMIT EQU O NO PROCESSOR TIME LIMIT 
SPACE 2 
LINKOPT 25,80 LINK OPTIONS 10B, LU 
SPACE 2 
IOTAB (0,INDX),(1,CNTG),(2,DEV),(3,SPL),(4,TAPE) 
SPACE 2 
UPRCLIM 30,30,,,40,3600,80, 10800 
SPACE 2 
UIOLIM (00,01,02,03,04),(100,101,102,103,104), U CLS 0 x 
(10,11,12,13,14),, U CLS 1 * 
(20,21,22,23,24),(120,121,122,123,124), U CLS 2 x 
(30,31,32,33,34),(130,131,132,133,134) U CLS 3 
SPACE 2 
PRMTDEV (FOX,CT30,CT32,CT34), x 
(SIGMA,SM50) 
SPACE 2 
PRMTSEQ (FOX,(*,O8FF),(-,O8FF),(>,FF),(BUILD>,FF)), x 
(SIGMA) 


It is recommended that the MTM sysgen parameter file that results 
from editing MTMPARMS.MAC be saved with a different extension. 
For example, MTMPARMS.MAC can be edited as above, with the new 
file saved as MTMPARMS.xxx where xxx is a 1- to 3-character 
alphanumeric extension. For a further explanation of this 
-parameter, see Section 2.3. 
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See the OS/32 EDIT User Guide for information on editing files. 


NOTE 


The macro names VERSION, LINKOPT, IOTAB, 
UPRCLIM, PRMTDEV and PRMTSEQ must begin 
in column 10. 


2.3 GENERATING A MULTI-TERMINAL MONITOR (MTM) SYSTEM USING THE 
STANDARD COMMAND SUBSTITUTION SYSTEM (CSS) COMMAND FILE 
(MTMSGN .CSS ) 


Perkin-Elmer supplies a CSS command file (MTMSGN.CSS) with the 
MTM package. MTMSGN .CSS assigns the SYSSTRUC .MLB and 
MTMSTRUC.MLB macro libraries. Therefore, MTMSGN.CSS may have _ to 
be edited via EDIT/32 to reflect the location of this file fora 
particular installation. For example, a volume and/or account 
classification (i.e., /P, /G, /S) may have to be specified for 
macro libraries. To call the standard CSS command file, enter 
the command as follows: 


Format: 
xxx 
MTMSGN 
MAC 
Parameter: 
XXX is a l1- to 3-character alphanumeric field that 


must be preceded by a space and must match the 
extension specified for the MTM sysgen 
parameter file (MTMPARMS). 


Functional Details: 


If the edited MTM sysgen parameter file was not saved with an 
extension different from that of the standard MTM_ sysgen 
parameter file or if the standard file is being used, MAC must be 
specified. 


Successful execution of MTMSGN.CSS returns condition code = 0 
upon completion of the MACRO/32 and CAL/32 processing phases. 


Upon successful completion of the link phase of MTMSGN.CSS, 
condition code = 1 is returned after the following message: 


*** WARNING: ABSOLUTE SPACE LESS THAN 100 *** 
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The files created are a source listing MTMMAC.LST and ae task 
MTMMAC.TSK. When a link error or assembly error (CAL/32) has 
occurred, see the source listing MTMMAC.LST. When a macro error 
(MACRO/32) has occurred, see macro expansion MTMMAC.EXP. If an 
extention was specified, see MITMxxx.LST, etc. 


2.4 MULTI-TERMINAL MONITOR (MTM) SYSTEM GENERATION (SYSGEN) 
OPTIONS 


The MTM sysgen options are: 


e CDBUFSIZ Sector buffer size 


@ CONBFSZ - Special console buffer size 
e@ CSBFSZ ~ Command buffer size 
@ IOTAB - I/O class table 


e LINKOPT - Number of I/O blocks and logical units for the Link 
OPTION command 


@ NCONBFS - Number of special console buffers 
e NCSBFS - Number of command buffers 


e NCSSLVS - Number of CSS levels 


e NMSGS - Number of message buffers — 
e@ NSECTS - Number of sector length buffers 
@® NUSERS - Number of concurrent users 


e PRCLIMIT - Batch job processor time limit 


@ PRMTDEV - MIM terminal prompt device name 


e PRMTSEQ - MTM terminal prompt sequence 
e@ QUESIZE - MTM task queue size 
e SGN.ACT - Number of accounting classes 


@ SGN.BTCP - Batch job pause 

e SGN.MVOL - Default user volume 

@ SGN.PRIO - Batch job relative priority 
@ SGN.ROLL - Forced roll 


e SGN.SCHR - Scheduling mechanism 
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e@ SGN.SPL 


Number of SPL/32 send data buffers 


e@ SGN.VAR - Number of global and local variables 


e SGN.@GLO Number of new global variables 


e SGN.@INT Number of internal variables 


e SGN.$HSP HASP interface 


e UIOLIM - I/O count limit for each accounting user class 


e@ UPRCLIM Processor time limit for each accounting user class 


e VERSION MTM version identification 


2.4.1 Sector Buffer Size (CDBUFSIZ) Option 


The CDBUFSIZ option specifies the number of sectors in a_ sector 
length buffer. For example, using this option to increase the 
length of the buffers for the DISPLAY FILES and variable-related 
commands causes a corresponding increase in the speed of MIM. 
The standard MTMPARMS file specifies a value of 3 for this 
option. To modify the standard value, edit this option as 
follows. 


Format: 
CDBUFSIZ EQU n 
Parameter: 
n is a decimal number from 0 to 6. 
Functional Details: 
The size of each sector buffer is set according to the following 
formula: 


(CDBUFS1IZ*256)+256 


The use of this option to increase the speed of the DISPLAY FILES 
command pertains only to files on disks that have been marked on 
with a secondary directory. The number of sectors calculated by 
the CDBUFSIZ option are read from the SYSTEM.DIR file each time 
a DISPLAY FILES command is executed. 
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If the disk is marked on with a secondary directory that can be 
contained in memory, MIM scans the memory buffer to search the 
directory. If CDBUFSIZ is set to 0, MTM does’ not scan _ the 
secondary directory to get the desired files; instead, the 
primary directory is scanned. 


When variable support is included in an MTM system, the size and 
number of sector buffers allocated determine the number of 
variables that can be contained in memory. Sometimes a user will 
attempt to define more variables than can fit into the user's 
allocated sector buffers. When this occurs, one of the allocated 
sector buffers is paged to disk and a freed sector buffer is made 
available to the user. This allows the user to define more 
variables. 


2.4.2 Special Console Buffer Size (CONBFSZ) Option 


The CONBFSZ option specifies the maximum length of the _ special 
console buffers generated by the NCONBFS' option. Since no 
special console buffers are reserved by the standard MTMPARMS 
file, the standard value of this option is 0. To specify the 
maximum length of each special console buffer reserved by MIM, 
edit this option as follows. 


Format: 
CONBFSZ EQU n 
Parameter: 


n is 0 or a decimal number from 72 to 32,767 
specifying the length of each special console 
buffer in the system. If the standard value 
of this option is changed, the value of n 
should be greater than the number specified in 
the command buffer size (CSBFSZ) option (see 
Section 2.4.3). 


2.4.3 Command Buffer Size (CSBFSZ) Option 
The CSBFSZ option sets the maximum length of the MTM system 
command buffers, including the buffers used for CSS commands. 


The standard value for this option is 80. To modify the standard 
value, edit this option as follows. 


Format: 


CSBFSZ EQU n 
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Parameter: 


n is a decimal number from 72 to 1,024. 


Functional Details: 


Since the last position of the command buffer is used for _ the 
carriage return (CR) character, the user should define a command 
buffer length one greater than needed. If a number less than 72 
is specified for n, a message is output and MTM goes to end of 
task code 7 when the .MTM START command is entered. 


2.4.4 Input/Output (1/0) Class Table (IOTAB) Macro 
The IOTAB macro defines values for the I/O class’ table. To 


change the default values, enter the IOTAB macro instruction as 
follows. 


Format: 


[label] IOTAB (c lassno,classid [, iocount]), 


rFeee ¢ 


(classno,classid [, iocount]), 


Operands: 

classno is a decimal number from 0 to 31 specifying a 
device or file class number. 

classid is a 4-character alphanumeric user-specified 
class identification associated with each 
device or file class. The classid is 
installation-dependent. 

iocount is a decimal number from 0 to 1,000,000 


specifying the maximum number of I/0 transfers 
to which each batch job associated with a 
particular device or file class is limited. 
If iocount is omitted, the default is 0O (no 
limit on I/O transfers). 


Functional Details: 
MTMSGN defines default values for the first four classes of the 


I/O class table as follows: 


IOTAB (0, INDX,0O),(1,CNTG,0O),(2,DEV,0),(3,SPL,0) 
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These default values may be modified by appending the IOTAB macro 
call, with the desired parameters, to the MTMPARMS.xxx file. 
This is demonstrated in Section 2.3. 

2.4.5 Multi-Terminal Monitor (MTM) Link (LINKOPT) Option 

The LINKOPT option sets the maximum number of I/0 blocks’ and 
logical units available to MTM. The standard MTMPARMS file 


permits four I/O control blocks and 30 logical units. To modify 
the standard values of LINKOPT, edit this option as follows. 


Format: 
LINKOPT n,m 
Parameters: 


n is the maximum number of I/O control blocks 
available to MTM. 

m is the maximum number of logical units 
available to MTM. 


Functional Details: 


The number of I/O control blocks need only be four, even ina 64 
user MTM environment. 


The minimum number of logical units that should be specified can 
be determined by the following formula: 


logical unit (lu) = 6+(NCSSLVS+1)*NUSERS or 254, 
whichever is smaller. 


MTM dynamically allocates logical units to subtasks as needed. 
The actual number of logical units available to MTM for dynamic 
allocation can be calculated as follows: 


available logical units = (number of logical units specified 
at MTM sysgen (LINKOPT) ) -NUSERS-6. 


To avoid a decrease in response time, the recommended number of 
logical units for NUSERS greater than 5 is: 


6+NUSERS * 2+ (NCSSLVS * 2 ) 
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To determine if the number of logical units specified by LINKOPT 
is sufficient, check the number of times MTM goes into an lu wait 
state by using the .MTM STATUS,WAIT command. This command 
returns a table similar to the one shown below. 


-MTM ST,W 
13:14:32 -MTM: TOTAL PEAK CURRENT WAITS 
13:14:34 .MTM: 42 34 ll 0 CMD BUFFERS 
13:14:37 -MTM: 0 0 0 0 CON BUFFERS 
13:14:40 -MTM: 7 4 0 0 SEC BUFFERS 
13:14:42 .-MTM: 50 24 19 0 LU 


A decision to increase or decrease the number of logical units 
specified by LINKOPT can be based on information returned by the 
-MTM STATUS ,WAIT command. 


The MTMMAIN object module has the following Link OPTION commands 
imbedded: 


OPTION COMMUNICATION, CONTROL, XSVC1,ETASK, INTERCEPT , ABSOLUTE=0 


These options can be overridden by using the NDCMD command to 
suppress imbedded Link options or by explicit specification of 
desired options using Link commands. 


The Link options IOBLOCKS and LU are contained in the MTMSGN 
source module. These options are selected as described above. 


For more information on Link commands and options, see the 08/32 
Link Reference Manual. 


2.4.6 Number of Special Console Buffers (NCONBFS) Option 


The NCONBFS option specifies the maximum number of special 
console buffers that can be used concurrently during MTM 
execution. No special console buffers are specified in the 
standard MTM sysgen parameter file. To specify the number of 
special console buffers to be reserved, edit this option as 
follows. 


Format: 
NCONBFS EQU n 
Parameter: 


n is a decimal number from 0 to 64. 
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Functional Details: 


The maximum number of special console buffers that can be used at 
one time is equal to the number of users (NUSERS). These special 
console buffers are used only when an I/O request is made to a 
user terminal that requires an I/O buffer larger than the size 
specified in the command buffer size (CSBFSZ) option. An example 
of this is the use of graphic buffers. 


Table 2-1 shows buffer types used in different situations. 


TABLE 2-1 BUFFER TYPES USED FOR 
SPECIFIC I/O REQUESTS 


I/O REQUEST SIZE } READ { WRITE } 
SRS ST EK BESS SSSA BSS SETS TES SESE SE SS SSS SS SVS SS SS \ 

< CSBFSZ | TUB ; TOB H 
ae aa eee See ee ee ea 
{ > CSBFSZ and t 
} £ CONBFSZ i} CON } CON H 
(ane Se Sere Se a ee a ee 
| » CSBFSZ and | TRUNCATE to jj} { 
H CONBFSZ = 0 i CSBFSZ | DIRECT 1 
} i a sa msc iy, ee nS a Ss Pm ci ‘ni elas a se ' 

TRUNCATE to 


Vv 
'?) 
oO 
a 
to 
"y 
Q 
N 


1 
§ 
CONBFSZ ; DIRECT 


Where: 
TUB (terminal is the dedicated buffer of size CSBFSZ for 
user buffer) each user. 
CON (console) is the special console buffer of size CONBFSZ. 
TRUNCATE truncates the read request. 
DIRECT performs the write request directly from the 


task. The task is made nonrollable for the 
duration of the I/0 call. 
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The decision to buffer large writes through the special console 
buffers or to perform the write directly from the task, should be 
based on: 


e the speed of the terminal, 
e the size of the write, and 


e the impact on other system users. The user task (u-task) is 
nonrollable for the duration of the write request. 


If an insufficient number of console buffers is allocated, a 
deadlock between two tasks might occur; e.g., both tasks enter 
into a console buffer wait state. If this happens, one of the 
two tasks involved should be cancelled. This deadlock situation 
is likely to occur if the special console buffers are used for 
read purposes and there is an insufficient amount of task space, 
causing tasks to be rolled. To monitor the number of console 
buffer waits, enter the .MIM STATUS parameter with the WAIT 
option. 


2.4.7 Number of Command Buffers (NCSBFS) Option 

The MTM program requires a minimum number of command buffers as 
follows: 

e One buffer for each user (terminal or batch job) 

@e One buffer for each active CSS level 

@ One buffer for each MESSAGE command 

e One buffer for each BROADCAST message 

e One buffer for each new global or internal variable 

MTM terminal response time depends on the number of available 
command buffers. To avoid poor performance, an adequate number 
of buffers must be allowed for MTM use. During MTM sysgen, three 
command buffers are reserved for each user; additional buffers 
can be reserved according to the number of CSS levels that may be 
active under MTM. The NCSBFS option tells MIM how many 
additional command buffers are to be reserved. The standard 


value for the NCSBFS option is 10. The length of these command 
buffers is specified by the CSBFSZ option. 
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To modify the standard value, edit this option as follows. 
Format: 

NCSBFS EQU n 
Parameter: 


n is a decimal number specifying the number of 
additional command buffers that can be used by 
the MTM system. Use the following formula to 
calculate n for your installation: 


n = (number of users) x (number of CSS 
levels + 1)/3 


The minimum number for n is O. 


Functional Details: 


Response time may be adversely affected if the value specified 
for mn is too small. Conversely, memory space is wasted if n is 
set above the maximum buffers needed. 


The program development feature of MTM uses new global and new 
internal variables extensively. A user who plans to use the 
program development feature or expects to use a large number of 
new global and new internal variables, may require a large number 
of command buffers. In such cases, the value of NCSBFS should be 
increased beyond that of the calculated formula above. The 
recommended minimum number of extra command buffers that should 
be specified per user of the program development feature is 15. 


The following methods can be used to judge whether the specified 
value for n is too small or too large for a particular system: 


@ Terminate MTM with the .MTM QUIESCE command. At end of task, 
MTM outputs the number of times it had to wait to geta 
command buffer. 


@ Enter .MITM STATUS,WAIT at the system console. This command 
Gisplays the total number of buffers available, peak usage, 
current usage and the number of times MTM had to wait for 
system resources on the user's behalf. 


e@ Enter .MTM STATUS,USED at the system _ console. This command 


displays in histogram form the number of times command buffers 
were used during MTM execution. 
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2.4.8 Number of Command Substitution System (CSS) Levels 
(NCSSLVS) Option 


The NCSSLVS option sets the maximum nesting depth of CSS 
routines. If one CSS routine tries to call another and exceeds 
the designated depth, the system responds with an error message 


and CSS processing ceases. To modify the standard value, edit 
this option as follows. 


Format: 
NCSSLVS EQU n 
Parameter: 


n is a decimal number specifying the maximum 
number of CSS levels. The minimum value for 
n is one; the maximum value is 1,024. 
2.4.9 Number of Message Buffers (NMSGS) Option 
The NMSGS option defines the maximum number of message buffers 
that MTM can reserve for operator commands and accounting 
messages from the file manager. The standard value for this 


option is NUSERS. To modify the standard value, edit this option 
as follows. 


Format: 
NMSGS EQU n 
Parameter: 


n is a decimal number from 1 to 1,024. A 
recommended value for n is NUSERS. 


Functional Details: 
MTM reserves 76 bytes per buffer. If these buffers overflow, the 


following message is displayed by the operating system: 


SVC6-ERR TYPE=NMSG POS= 
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2.4.10 Number of Sector Length Buffers (NSECTS) Option 


The NSECTS option specifies the maximum number of sector length 
buffers that can be used by MTM for commands that require this 
buffer type. These commands are DISPLAY FILES, $GLOBAL, $LOCAL, 
$SET and $FREE. The number of sector length buffers specified by 
the standard MTMPARMS file is NUSERS/2. To modify the standard 
value, edit this option as follows. 


Format: 
NSECTS EQU n 
Parameter: 


n is a decimal number specifying the maximum 
number of 256-byte sector buffers. The 
minimum value for n is 1. A recommended value 
for n is NUSERS/2. 


Functional Details: 


When variable support is included in an MTM system through the 
SGN.VAR option, a sufficient amount of sector buffers should be 
reserved to hold MTM variables. A 256-byte (one sector) buffer 
can contain a maximum of seven variables. The amount of sector 
buffers needed depends upon the number of users, the number of 
variables being used, and the size of the _ sector buffers. 
Ideally, two 256-byte sector buffers per user should be 
allocated; a maximum of four per user can be allocated to a 
sector buffer pool. Very large sector buffers can also be 
allocated using the CDBUFSIZ option. If an insufficient number 
of sector buffers is allocated, the buffer pool can run empty, 
causing the user to go into a sector buffer wait state. 


When variable information is not required, sector buffers are 
paged to disk. The resulting freed buffers are returned to the 
sector buffer pool. Because of this paging to and from disk, the 
size of each sector buffer is an important factor in processing 
variables. 
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2.4.11 Number of Concurrent Users (NUSERS) Option 
The NUSERS option defines the maximum number of terminal users 
and batch jobs that can be executed concurrently. The value 


specified for this option in the standard MTMPARMS file is 4. To 
modify the standard value, edit this option as follows. 


Format: 
NUSERS EQU n 
Parameter : 
n is a decimal number from 1 to 64. 


2.4.12 Batch Job Processor Time Limit (PRCLIMIT) Option 


The PRCLIMIT option defines the maximum processor (PRC) time (in 
seconds) for a batch job running under MTM. In a Model 3200MPS 
System environment, PRCLIMIT defines the maximum processor time 
(CPU+tAPU), for a batch job running under MTM. No processor time 
Limit is set by the standard MTMPARMS file. To set the processor 
time limit, edit this option as follows. 


Format: 
PRCLIMIT EQU n 
Parameter: 


n is a decimal number from O to 86,400 (24 
hours) specifying the maximum processor time 
(in seconds) to which each batch job is 
limited. If O is specified, no limit applies. 
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2.4.13 Multi-Terminal Monitor (MTM) Terminal Prompt Device 
Name (PRMTDEV) Macro 


The PRMTDEV macro defines the devices to be used with the prompt 
sequences specified in the PRMTSEQ macro. Any terminal device 
not defined by the PRMTDEV macro will use the standard prompt 
sequences. The PRMTDEV macro is used as follows. 


Format: 


label] PRMTDEV 7a nar 
eee ON ce eeeien Goede 


[abel] PRMTDEV (sIGMA,dev, [,...,devn]) 


Operands: 


pname is the 1- to 8-character prompt sequence name 
specified in the PRMTSEQ option (see Section 
2.4.14). 

dev is the device name of the terminal. 

SIGMA is the predefined prompt sequence for the 


Perkin-Elmer SIGMA 10 terminal. 
Example: 
PRMTDEV (FOX,CT30,CT32,CT34),(SIGMA,SM50) 
2.4.14 Multi-Terminal Monitor (MTM) Terminal Prompt Sequence 
(PRMTSEQ) Macro : 

The PRMTSEQ macro defines prompt sequences for terminals 
requiring special prompt sequences. This macro is used in 
conjunction with the MTM terminal prompt device name _  (PRMTDEV) 


macro and is only required if the user wishes to use a terminal 
prompt sequence other than the standard sequence. 
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Format: 


(labei] PRMTSEQ 


[label] PRMTSEQ 


[label] PRMTSEQ 


Operands: 
SIGMA 


pname 


com req 

task exec 
task read 
build-read 


STANDARD 


(SIGMA) 
(pname, , (com-req,x), (task-exec,x), 


(task-read,x) , (build-read,x) ), 


(pname, , (com-req,x), (task-exec,x), 
(task-read,x), (build-read,x) )n] 


(STANDARD, (com-req,x), (task-exec,x), 
(task-read,x), (build-read,x), 


requests the predefined prompt sequence for 
the Perkin-Elmer SIGMA 10 terminal. 


is a l- to 8-character alphanumeric prompt 
sequence name. This parameter corresponds to 
that specified for the PRMTDEV macro. 


is zero to eight ASCII characters defining the 
prompt sequence for a command request. 


is zero to eight ASCII characters defining the 
prompt sequence for task or CSS execution. 


is zero to eight ASCII characters defining the 
prompt sequence for a task read. 


is zero to eight ASCII characters defining the 
prompt sequence for a build read. 


redefines the standard prompt sequence, which 
is as follows: . 

@e Command read (*,FFFFFF) 

e Task/CSS executing (-,FFFFFF) 

e task read (>,FFFFFF) 

@ Build read (B),FFFFFF) 


is a hexadecimal pad sequence from zero to 
eight bytes. 
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Functional Details: 


The total length of the ASCII character sequence and the 
hexadecimal pad sequence cannot exceed eight bytes. 


When specifying more than one set of prompt sequences, a comma 
must be placed immediately following the last parameter specified 
on a line and an asterisk (*) must appear in column 72 to 
designate continuation of the operands. 


Example: 
PRMTSEQ (BS, (*,O8FF),(-,O8FF),(>,FF),(BUILD),FF)), - 
(SIGMA) 
2.4.15 Multi-Terminal Monitor (MTM) Task Queue Size 


(QUESIZE) Option 
The QUESIZE option specifies the maximum size of the task queue 
used by MTM. The standard MTMPARMS file specifies NUSERS for 


this option. To modify the standard value, edit this option as 
follows. 


Format: 


QUESIZE EQU n 


Parameter: 
n is a decimal number specifying the maximum 
number of slots for the MTM task queue. The 
maximum value for this option is 200. A 


recommended value for n is NUSERS. 


2.4.16 08/32 Accounting Facility (SGN.ACT) Option 

The SGN.ACT option enables support for the OS/32 Accounting 
Facility under MTM. The standard MTMPARMS file does not support 
the Accounting Facility, but to enable support and specify the 


maximum number of device and file classes that can be used, edit 
this option as follows. 


Format: 


SGN.ACT EQU n 
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Parameter: 


n is a decimal number from 2 to 32 specifying 
the maximum number of device and file classes 
to be used by the Accounting Facility. A O 
indicates no accounting support. 


Functional Details: 
The value of n should be greater than, or equal to, the number 
specified in the 0OS/32 accounting configuration statement. A 


minimum value of 2 is required to support indexed and contiguous 
files. 


2.4.17 Batch Job Pause (SGN.BTCP) Option 


The SGN.BTCP option allows a batch job running under MTM to pause 


without being cancelled. The standard value of this option 
causes a batch job running under MT to be cancelled whenever 
execution of that job is suspended. To enable the batch job 


pause option, edit this option as follows. 


Format: 


SGN.BTCP EQU 1 


Functional Details: 

The batch job pause option is enabled by equating SGN.BTCP to 1. 
If this option is enabled, a message is output to the system 
console when a batch job pauses. The system operator can then 
take appropriate action. 

2.4.18 Default User Volume (SGN.MVOL) Option 

The SGN.MVOL option defines the default volume for an MT user. 
The standard MTMPARMS file defines the system volume as the 


default user volume. To specify a default volume, edit this 
option as follows. 


Format: 


SGN.MVOL EQU C'name' 
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Parameter: 


name 


is the name of the disk volume to be used as 
the default user volume for all users at 


Signon time. This name must be four 
characters; the first character must be 
alphabetic, the remaining alphanumeric. If 


less than four characters are used, the 
remaining characters must be blanks, e.g., 
C'MTM '. Four blank characters indicate that 
the default user volume is the system volume. 


2.4.19 Batch Job Relative Priority (SGN.PRIO) Option 


The SGN.PRIO option 
batch job running 
this option as foll 


Format: © 


SGN.PRIO EQU n 


Parameter: 


Functional Details: 


Default priorities 
as follows: 


TYPE OF JOB 


defines the relative default priority of a 
under MTM. To modify the standard value, edit 
ows. 


is a decimal number from 0 to 20 that is added 
to the MTM default priority (MTMdp) of an 
interactive job to determine the absolute 
priority at which an MTM user's batch job will 
run. For example, the standard value of 6 
indicates that a batch job will run at six 
priorities lower than an interactive job 
unless otherwise specified. If 0 is 
specified, 0 is added to the MTMdp of an 
interactive job, indicating that a batch job 
will run at the same priority as an 
interactive job unless otherwise specified. 


for interactive and batch jobs are calculated 


PRIORITY 


MTM MIM link priority 


Interactive MTMdp = MT link priority + 12 


Batch MTMdp + SGN.PRIO = MTM link priority + 12 +n 
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Once these default priorities are established, any priorities set 
by an MTM user in the SUBMIT command are checked against the 
default priorities. A batch job is always run at the lowest 
possible valid priority and is never run at the same priority as 
MIM. Default priorities for interactive jobs are not affected by 
this option. 


Example: 

LE: 
MTM link priority = 128 
SGN.PRIO = 10 


the following become the MIM default priorities of interactive 
and batch jobs: 


140 
150 


Interactive job 
Batch job 


As shown in the following examples, priorities specified by an 
MIM user in the SUBMIT command are checked against the default 
priorities established at MTM sysgen. 


Example: 
Assume the following SUBMIT commands are entered by an MTM user 


(SGN.PRIO=10): 


SUBMIT TEST .JOB, PR=138 
SUBMIT TEST1.JOB, PR=150 


The priority for TEST.JOB is invalid, because the user specified 
the submitted job to be run at a higher priority than the MTMdp 
of 140. The job will be run at 150. 


The priority for TEST1.JOB is valid, because it is lower than the 
MTMdp of 139. 


The batch job TEST1.JOB will be run at the specified priority of 
150. 

Example: 

Assume the following SUBMIT commands are entered by an MTM_ user. 


The jobs will be run at either the MTMdp for batch jobs or the 
link priorities, whichever are lower (SGN.PRIO=6). 
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LINK 


JOB PRIORITY 
SUBMIT TEST.JOB 128 
SUBMIT TEST1.JOB 200 
SUBMIT TEST2.J0B,PRIO=160 180 


TEST.JOB will be run at the batch priority of 146, which is lower 
than the link priority of 128. 


TEST1.JOB will be run at the link priority of 200, which is lower 
than the batch priority of 146. 


TEST2.JOB will be run at the link priority of 180, which is lower 
than both the submit priority of 160 and the batch priority of 
146. 


2.4.20 Forced Roll (SGN.ROLL) Option 


In most operating system environments, it is desirable to make 
every task running under MTM rollable. With the SGN.ROLL option 
enabled, every task except executive tasks (e-tasks) loaded by 
MTM is made rollable at load time. The standard MTMPARMS file 
enables forced roll. To disable forced roll, edit this option as 
follows. 


Format: 
SGN.ROLL EQU 0O 


Functional Details: 


This option applies only to the private image segment of the 
task. Shared segments are not rolled. See the OS/32 Application 
Level Programmer Reference Manual for a description of the task 
image segments established by Link. 


2.4.21 Multi-Terminal Monitor (MTM) Scheduling (SGN.SCHR) Option 


The user can select one of three scheduling techniques available 
through the SGN.SCHR option: 0OS/32 priority scheduling, dynamic 
priority scheduling and the MT priority scheduling mechanism 
(PSM). The PSM is required for use of the load leveling 
executive (LLE) on a Model 3200MPS System (see Chapter 6). 
Dynamic priority scheduling is specified by the standard MTMPARMS 
file. To modify the standard value, edit this option as follows. 
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Format: 


SGN.SCHR EQU n 


Parameter: 


n may be 0, 1 or 2 wherc: 


® O indicates 0S/32 priority scheduling. 


e 1 indicates dynamic priority scheduling. 


e 2 indicates the MTM PSM. 


Functional Details: 


When 0 is selected for n, no special task scheduling is done for 
MTM subtasks. The standard task scheduling of OS/32 is used; 
i.e., tasks are run according to their priority and the 
time-slice value from the SET SLICE command. Tasks of equal 
priority are scheduled on a first-in/first-out (FIFO) basis. See 
the OS/32 Application Level Programmer Reference Manual for more 
information on OS/32 priority scheduling. 


When 1 is selected for n, dynamic priority and time-slice 
scheduling is activated for MTM _ subtasks. Through dynamic 
scheduling, a task's priority is adjusted through a range of 13 


priorities, 
from 20ms to 2 minutes. 


while a task's time-slice is adjusted through a range 
Computation-intensive tasks (i.e., tasks 


that 
to the next lower priority and 
I1/O-intensive tasks (i.e., tasks 
consume their time-slice) are 
priority and their time-slice is 
MTM subtasks by 0OS/32 ensures 
terminal I/O are adjusted to the 
When 2 is selected for n, the 
subtasks. PSM increases 


priorities of MTM subtasks according to their run-time 


consume their time-slice without an interrupt) are adjusted 


their time-slice is doubled. 
that are interrupted before they 
adjusted to the next higher 
halved. Dynamic scheduling of 
that tasks requiring interactive 
highest allowable priority. 


MTM PSM is activated for MIM 
system throughput by adjusting the 
behavior. 


PSM performs a periodic check on the run-time behavior of all MTM 


subtasks and based 
the priorities of subtasks whose 


in the range of *+12 to *+128, where * equals the 


for .MTM. The interval of the 


on this behavioral information, 


PSM adjusts 
initial load priorities had been 
task priority 
above check is controlled by the 


operator command .MTM PSM INTERVAL described in Chapter 6. 
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All current subtask priorities outside this range and those 
priorities set by the PRIOR command or the SUBMIT command at load 
time are fixed. Fixed priorities cannot be modified by PSM and 
PSM cannot alter the maximum batch priority set by the SGN.PRIO 
option. Table 2-2 summarizes task priority modification when PSM 
is enabled. 


PSM lowers the task priorities of subtasks requiring a relatively 
large amount of CPU time, while raising the priorities of 
subtasks that perform a large number of I/O operations. PSM will 
not raise a task's priority above the priority set at link time 
(except when the task is rolled). 


All priorities assigned by PSM (except for rolled-out tasks) must 
be within the *+12 to *+128 range. To increase the chances of 
entry of a rolled-out subtask into the system, PSM gradually 
raises the priority of the subtask to *+l. Once the’ subtask is 
rolled-in, PSM adjusts its priority immediately within the *+12 
to *+128 range. 


Accounting support is required with PSM; both MTM accounting and 
0S/32 accounting must be sysgened for accounting support. 


TABLE 2-2 MODIFICATION OF MTM SUBTASK PRIORITIES WITH 
| PSM ENABLED 


ee 


I ALLOWABLE PRIORITY 
1 PRIORITY | DEFAULT TASKS  ; MODIFICATION 


{ Nee ee ee ne ee te eee ee ee ee ee ee eee H 
H * {| .MTM | Fixed priority - cannot | 
| { .MTMASST i be modified by PSM. H 
} -9PL i i 
; -SPLR i 
sk a lt a a a a a aaa aa 
; * to +1 } None | Fixed priority range - 
H : i } can be modified by a H 
1 : H | PRIOR or SUBMIT command i 
H ¢ H | issued by a user with the } 
; * to +11 { } privilege to alter batch | 
H {| priorities. ! 
| ean nnn nn nn nn nn nnn nn nnn nnn nn nnn nnn nn nnn nnn nnn nnn nena | 

* to +12 All MIM inter- Subtasks whose priorities 

active tasks lie within this range can 

be modified by PSM accor- 

* to +13 All batch MTM ding to their run-time 


all tasks (except rolled- 
out tasks) adjusted by 
PSM must remain within 


} jobs | behavior priorities for H 
' ! ' 
! ! ! 
i this range. 
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TABLE 2-2 MODIFICATION OF MTM SUBTASK PRIORITIES WITH 
PSM ENABLED (Continued) 


ALLOWABLE PRIORITY 
PRIORITY DEFAULT TASKS MODIFICATION 
q SSS SSSSSSSsSsSSsS BS SSS SSIS SSS SS TEE EVCEBTSBoSB8eVBVsS SCTE ST BSSesesSsEVwswsa sas 
* to +13 PSM raises or lowers task 
(continued) priorities for batch jobs 
as it does for inter- 
active tasks, except that 
PSM cannot raise a batch 
job priority higher than 
the maximum set at MTM 
sysgen (see SGN.PRIO). 


NOTE 


Priorities in this range 
that have been set by 
the PRIOR or SUBMIT 
commands are boundaries 
for PSM. PSM only lowers 
these priorities as need- 
ed and never raises a 
priority higher than the 
248 (whichever priority set through the 
is smaller) PRIOR or SUBMIT command. 
* to +129 or | Fixed priority range - 
249 (whichever | can be modified by the 
is smaller) | PRIOR command or at link 
| time, but only up to 254. 
{ 
7 
H 


* to +128 or 


—— ee ee ee ee eee eee emer eee eee eee eee eee eee wee ee eee wee eee we oe 
an woem qwee ween wee ee ew ee ee eee ee ee ee ee ew ww ee ee ee 


NOTE 


To obtain good system performance, use 
the PRIOR 1 command in the standard 
system CSS (on Account 0, system volume) 
for interactive tasks; otherwise the 
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tasks are lowered too far in priority. 


Even a user without PRIOR command 
privileges is able to raise a task's 
priority if the PRIOR command is used in 
a CSS file on the system volume and 
system account. 
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See the Multi-Terminal Monitor (MTM) Reference Manual for more 
information on the PRIOR command. 

2.4.22 SPL/32 Interface (SGN.SPL) Option 

The SGN.SPL option gives MTM users access to the SPL/32 software. 
SPL/32 must be configured into the system during OS/32 sysgen; 
otherwise, this option has no effect on the system. The standard 
MTMPARMS file does not enable the SPL/32 interface. To enable 


SPL/32 support and specify the desired number of send data 
buffers, edit this option as follows. 


Format: 
SGN.SPL EQU n 
Parameter 
n is the number of send data buffers. 


Functional Details: 


When O is selected for n, SPL/32 support is disabled. If SPL/32 
support is desired, a recommended value for n is NUSERS. 


To judge whether the value specified for n is too small or _ too 
large for a particular system, enter .MTM STATUS,WAIT at the 
system console. This command displays the total number of 
buffers available, peak usage and current usage. 

2.4.23 Global and Local Variables (SGN.VAR) Option 

The SGN.VAR option specifies the maximum number of global and 
local variables that an MTM user can define. The maximum number 


specified by the standard MTMPARMS file is 28. To modify the 
standard value, edit this option as follows. 


Format: 


SGN.VAR EQU n 
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Parameter: 


n is a decimal number from 28 to 1,024 
specifying the combined maximum number of 
global and local variables a user can define. 
If n equals 0, variable support is not 
included in MTM. 


2.4.24 Number of New Global Variables (SGN.@GLO) Option 

The SGN.@GLO option specifies the maximum number of new global 
variables that can be defined by an MTM user via the $DEFINE 
command. The maximum number of new global variables specified by 


the standard MTMPARMS file is 15. To modify the standard value, 
edit this option as follows. 


Format: 


SGN.@GLO EQU n 


Parameter : 
n is a decimal number from 0 to 99 specifying 
the maximum number of new global variables 
allowed. 


Functional Details: 
Each new global variable defined by a user occupies one command 


buffer. Therefore, the number specified for this option should 
be considered when specifying the NCSBFS option. 


2.4.25 Number of New Internal Variables (SGN.@INT) Option 

The SGN.@INT option specifies the maximum number of new internal 
variables that can be defined in an MTM user's CSS command file 
via the $DEFINE command. The maximum number of new internal 


variables specified by the standard MTMPARMS file is eight. To 
modify the standard value, edit this option as follows. 


Format: 


SGN.@INT EQU n 


2-28 48-023 FOO RO3 


Parameter: 


n is a decimal number from 0 to 99 specifying 
the maximum number of new internal variables 
allowed in a CSS command file. 


Functional Details: 


Each new internal variable defined by a user occupies one command 
buffer. Therefore, the number specified for this option should 
be considered when specifying the NCSBFS option. 


2.4.26 HASP Interface (SGN.$HSP) Option 


The SGN.$HSP option allows terminal users to switch from an MTM 
time-sharing environment to a HASP environment. The standard 
MTMPARMS file does not enable the HASP interface. To enable the 
HASP interface, edit the SGN.$HSP option as follows. 


Format: 
SGN.$HSP EQU n 
Parameter: 


n is a decimal number from 1 to 99 specifying 
the maximum number of HASP/32 tasks that can 
be concurrently interfaced with the $HASPxx 
command by MIM users. If n equals 0, the HASP 
interface feature is disabled. 


2.4.27 Input/Output (1/0) Count Limit Per Accounting User Class 
(UIOLIM) Macro 


The UIOLIM macro defines the maximum number of I/0 transfers, 
within each I/O class, allowed for each task run from a terminal 
or batch stream, for a given user class (0 through 15). To 
define I/0 count limits for each user class, first enable the 
0S/32 Accounting Facility using the SGN.ACT option and establish 
I/O classes for MTM using the IOTAB macro. Enter the UIOLIM 
macro as follows: 


Format: 


[label] UIOLIM (uptoobraecatte tone); (u pidgb, ...,U9ionb) 
Annee 


(uniogt,-..,Uniont) (Un i0ob,. - + UniOnb) 
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Operands: 


UpAiont is a decimal number ranging from 0 to 
1,000,000 indicating the maximum number of I/O 
transfers to the device assigned to I/0 
class n for all interactive tasks run from a 
terminal for user class n. If Uniont for a 
given user class is omitted or equals 0, the 
I/O count limits specified for each I/0 class 
by the IOTAB macro are in effect for that 
class. 


u,7ionb is a decimal number ranging from 0 to 
1,000,000 indicating the maximum number of I/0 
transfers to the device assigned to I/0 
class n for all batch jobs for user class n. 
If up,io,b for a given user class is omitted or 
equals 0, the I/O count limits specified for 
each I/O class by the IO0TAB macro are in 
effect for that class. 


Functional Details: 


If a task attempts to exceed an I/O count limit set for the user 
class to which its account belongs, task execution is terminated 
with an end of task code 1210. All outstanding jobs 
corresponding to the exceeded I/O count limit are aborted. 


Because the IOTAB macro defines the I/O classes for MT, the 
IOTAB macro must precede UIOLIM in the MTM parameter file. 


Interactive I/O counts for all I/O classes must be enclosed in 
parentheses; a comma is then used to separate the interactive I/O 
counts from the batch I/O counts (also enclosed in parentheses) 
for the same user class. Similarly, a comma following the batch 
I/O counts for all I/O classes is used to separate the parameters 
for one user class from those of the next user class. 


The following example is designed to illustrate the format of the 
UIOLIM macro and its relationship to the IOTAB macro. 
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Example: 


IOTAB (0, INDX),(1,CNTG),(2,DEV),(3,SPL),(4,TAPE) 


UIOLIM (00,01,02,03,04),(100,101,102,103,104), U CLS 0 x 
(10,11,12,13,14),, U CLS 1 x 
(20,21,22,23,24),(120,121,122,123,124), U CLS 2 x 
(30,31,32,33,34),(130,131,132,133,134) U CLS 3 x 

Ic Ds T I cop s 
N N E PA N N E P A 
DT V L P D T %V L P 
X G E Xx CG E 
TERMINAL BATCH 


Table 2-3 illustrates the I/O count limits set for batch and 
terminal jobs by the above example of UIOLIM. 


TABLE 2-3 EXAMPLE I/O COUNT LIMITS SET BY UIOLIM 


I i 1/0 CLASS { 
‘ {OPS SSS re Stoel osee sere Se Sees ear eeeSr SS See Sa Sees SSeS SS een eras i 
H H 0 (INDX) | 1 (CNTG) H 2 (DEV) H 3 (SPL) i 4 (TAPE) H 
} ACCOUNTING | ------- ror rrr nr rer nr nnn nn ne nn nen ee H 
| USER CLASS ; TERM. } BATCH | TERM. | BATCH ; TERM. ;} BATCH ;} TERM. | BATCH ; TERM. | BATCH | 
\== SRE KARST BER ETE SE ee RES KRKSKRSEBKESREARKRALRARKBRAAARLBKAATERARRA Se SS SR RS SSSSFS SES BuePER SSF TSS RRMA sD H 
i 0 i x i; 100 | 1 i 101 } 2 jf 102 } 3 1 103 |} 4 i; 104 | 
H ee ea me me ees ee ee ee ee a a a a a a a a ee ee en H 
i 1 ; 610 ' eas (me i ee he 1 Be} 8 i ce a RA 
PRO SS Se SS MRSS SRS SSeS SSR Se SSSA SRS Sr Sas SRS Seer Sse aS SH SSS ss esse ase ser sr sea esas seerss= i 
H 2 i 20 ; 120° 4 21 i; 121 { 22 i; 122 {| 23 i 123 | 24 + 124 |{ 
bm a a rrr ree i 
H 3 i 30 i 130 ¢; 31 i 131 | 32 i; 132 {| 33 ; 133 { 34 1 134 | 
cs aa SF ak cae Sy: Se een’ sabe Tess alc“ vo tine] Sem vn: ssc Teen” Sal's Ze <b 5 ems“ Keim“ uy “Ss SiMe” oun “mn nbn Gaim) Fem mm “Sn se Gms Gp ln is Gn“ tm“ mn Su mpd pus "de" SV Pcs em se ! 
4 ' x \ xk H x { xx { «x : xx \ x : xx ; x H Kx 
* No I/O count limit 

** 1/0 count limit set by IOTAB macro 

NOTES 


The actual I/0 count limits used in the 
previous example are for illustrative 
purposes only and should not be construed 
as recommended parameters to the UIOLIM 
macro. | 


48-023 FOO RO3 . 2-31 


2.4.28 Processor Time Limit Per Accounting User Class (UPRCLIM) 
Macro 


The UPRCLIM macro defines the maximum processor time allowed for 
each accounting user class for MTM tasks running in a single 
processor system. In a Model 3200MPS System, UPRCLIM defines the 
maximum processor time (CPU+tAPU) allowed for each accounting user 
class. There is a maximum of 16 accounting user classes (0 
through 15) established in the authorized user file (AUF). Each 
account is assigned to one of the established accounting user 


classes. A terminal session or batch job is limited to the 
processor time designated for the class to which the account 
belongs. To define processor time limits for each user class, 


first enable the OS/32 Accounting Facility using the SGN.ACT 
option. Then enter the UPRCLIM macro as follows. 


Format: 


[label] UPRCLIM limit,t,limitob,limit,t,limit,b, 


Llimit,t, limitnb 
Operands: 


Limityt is a decimal number ranging from 0 to _ 86,400 
(one day) indicating the maximum number of 
seconds of processor time allowed any terminal 
session for a user signed on to an account in 
user class n. If lLimit,t equals 0, no 
processor time limit applies to terminal 
sessions under class n. 


Limityb is a decimal number ranging from 0 to _ 86,400 
(one day) indicating the maximum number of 
seconds of processor time allowed any batch 
job running under an account in user class n. 
If limitpnb equals 0, the default processor 
time limit is the limit set by the PRCLIMIT 
option at MTM sysgen. 


Functional Details: 


If execution of a task under any account exceeds the processor 
time limit set for the accounting user class to which the account 
belongs, the task is terminated (end of task code 1200). After 
termination, no other tasks can be loaded under that account and 
all batch jobs under that account are aborted. 
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Example: 
UPRCLIM 30,30,,,40,3600,80, 10800 


In the above example, the processor time limit for both batch 
jobs and terminal users in accounting user class 0O is 30 seconds. 
Accounting user class 1 has no processor time limit for terminal 
users; batch jobs are restricted by. the limit set in PRCLIMIT. 
For user class 2, the processor time limit for terminal users is 
40 seconds, while batch jobs are limited to 3600 seconds (one 
hour). Class 3 users are limited to 80 seconds for terminal 
users and 10,800 seconds (three hours) for batch jobs. For the 
remaining classes, no processor time limits are set for terminal 
sessions; batch jobs running under these classes are limited to 
the value set by the PRCLIMIT option. 


2.4.29 Multi-Terminal Monitor (MTM) Version Identification 
(VERSION) Macro 
The VERSION macro assigns an identification name or number to the 


current revision of the MTM system. To specify an identification 
name for an MTMPARMS file, edit this option as follows. 


Format: 


[label] VERSION ‘id! 


Operand: 

id is a 16-character alphanumeric string 
identifying the current revision of the MTM 
system. Special characters are allowed. If 
blanks are used, the identification name must 
be enclosed in quotes. 

Example: 


VERSION '3230-B' 
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2.5 MEMORY REQUIREMENTS FOR SYSTEM GENERATION (SYSGEN) OPTIONS 


The MTM sysgen options reside in data structures built within the 


MIM task address space. 


its size. 


TABLE 2-4 DATA STRUCTURES 


Table 2-4 lists each data structure 


BUILT BY MTM SYSGEN 


and 


DATA 
STRUCTURE 


parameter 


’ 

' 

i Sysgen 
! 

{ 

{ area 

1 

{ 


MEANING 


Contains the sysgen 
parameter values to 
be used by the 
MTMMAIN module. 


SIZE (IN BYTES) 


BCC RCo SSCS CTV BSEBCEBoS TSS SSeS 


128 


One is built for 
each concurrent MTM 
user defined by the 
NUSERS option. 


584+ (NCSSLVS+1) *8 
+CSBFSZ+4 
+SGN .ACT*4+4 


Command 


area 


Contains the command 
buffers. 


Special 


buffers 


Contains the pool of 
special console 
buffers. 


! 
t 
i console 
( 
! 


| Message 
} area 
Sector 


t 
t 
{ 
! 
| area 
i] 
i] 


Contains the message 
buffers. 


Contains the sector 
buffers. 


a ee ea ae ee eee ee a eee a ee ee ee ee ee nd eee 


Contains the MTM 
task queue. 


{ 
' 
{ List 


Contains the command 
buffer wait queue. 


Contains the console 
buffer wait queue. 


i Circular 
i} list 
ji area 4 


Contains the sector 
buffer wait queue. 


4*NUSERS+8 
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TABLE 2-4 DATA STRUCTURES BUILT BY MTM SYSGEN (Continued) 


Se a ee eS Ree SE Ge nee ee SS ey Gee mee Gee mee See Ge wee Se eee erm mee Se ee es em. GE eet Cu cum OS nee em ies cme ee ee em me ee cm nee ee ee et ee ce ee ey ee 


DATA 

| STRUCTURE } MEAN ING H SIZE (IN BYTES) 

| SSE GBTESSCBBEMEBRBTAETEABEECEA BCs aA CCC ECSBwE CKO CBSEBSBre scTwAT Bt est=== 
| Circular | Contains the lu wait |} 4*NUSERS+8 

} list | Queue. | 

| area 5 H 

H Si aj Sms ib GOS unin jis “am Se ras ci) tha Geass igs ‘Gyo (eas mens" mex ests ame cis ht Gs “Via ong besa ac acs en ei, ay ‘gts an Fa: eed 
| Circular ; Contains the message | 4*NMSGS+8 

} list | buffer wait queue. i 

| area 6 


ee eee ee ee ee ee ee SE Se ee eee OY ee ee cee ee Se See eee Oe ee es ey Ge Oe SD Se ee eee SE Oe Se ee ee Se eee me me ee om oe aime GE EP GS tee ee me ee, Oe ee ee ee ee ee ee ee ee ee 


Accounting} Used by MTM to write 128 or 8*classes+84 


H 

| | | 

| write | accounting informa- {| (whichever is larger) 

i buffer i; Cion to the account- | 

| ing transaction file |} 

| (ATF). 

\ ee ee ee ee ee oe en ee ee i 
Command Used to accumnulate (3*NUSERS+NCSBFS ) *4 
buffer 


{ ( i 
t) ’ J 
i { command buffer usage } 
; usage | for the .MTM STATUS, | 
| USED command. 
( 


I/O class 
table 


| Contains the 1/0 H 
} accounting class 1 
i} name and limits. H 
| This table is built | 
{| by the IOTAB macro. |} 
PRC limit {| Contains the PRC H 
table i; limits for terminals |} 
{ and batch jobs for { 
} each user class. { 
{} Built by the UPRCLIM |} 
} macro. | 
I/O limit | Contains the I/0 |} 128*SGN.ACT 
table {| limits for terminals } 
{ and batch jobs for H 
{ each 1/0 class by H 
‘ user class. Built { 
| by the UIOLIM macro. } 
SPL/32 | Contains the mnemon- | 260*SGN.SPL+532 
send data | ic table, send data | 
| buffer queue and { 
i send data buffers | 
{} used by MTM and | 
i SPL/32. { 
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CHAPTER 3 
AUTHORIZED USER UTILITY 


3.1 INTRODUCTION 


Prior to loading and starting the multi-terminal monitor (MTM), 
an installation must establish valid account numbers” and 
passwords for its authorized users. This is accomplished through 
the Authorized User Utility supplied with the MTM software 
package. The Authorized User Utility maintains a file containing 
information on each account number. This file is called the 
authorized user file (AUF). 


3.2 AUTHORIZED USER FILE (AUF) 


The AUF contains one record for each account. An account number, 
group number and password are required for each account. In 
addition, user identification, limits for signon and processor 
time and privileges for each account can be optionally specified 
in the AUF. Defaults are set by the Authorized User Utility for 
all optional information not specified by the installation. The 
record format for the AUF is shown in Figure 3-1. 
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136(24) 


Userid (20 characters) 


ma ome ie ee eee 


eo een ey ae om ome 


156(38) 
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on et ee ee ee oe 


1124(7C) 
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ee rd 
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Figure 3-1 AUF Record Format 
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The Authorized User Utility is used to create, update and report 
on the AUF. 


Initially, the Authorized User Utility should be run from _ the 
system console to create an AUF. In order to enable access under 
MTM, the AUF must be renamed to account 255. 


Example: 
RENAME USERS .AUF ,USERS.AUF/255 


Once the AUF is renamed to account 255, it can be updated while 
MTM is running by signing on to account 255 and running the 
Authorized User Utility. 


When the AUF is assigned to account number 255, it is protected 
in two ways: 


@ only users signed on to account number 255 can access the AUF, 
ana 


e the Authorized User Utility does not display the password to 
account 255 ina listing. 


When the LIST command of the Authorized User Utility is entered, 
the account number, group account number, user identifier 
(userid), signon time remaining, processor time remaining, 
account privileges and date of last report are displayed. Once 
added to an account record, the password cannot be retrieved from 
the AUF, but can be changed by the CHANGE command. 


Accounting limits and privileges can be specified for each 


account number through one of the _ following Authorized User 
Utility commands: 


e ADD command (create or update mode), used when adding a new 
account to the AUF. 

@ CHANGE command (update mode), used when making changes to an 
already existing account. 


Two resources can be limited by account number: 


e Signon time 


e Processor time 
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Signon time can be limited for each account by specifying the 
maximum time the total number of terminal users assigned to that 
account can be signed on to the system. Whenever a terminal user 
signs off the system, these limits are checked. If the terminal 
user has used all of the remaining signon time specified for that 
account, or tries to sign on to an account with no signon time 
left, the signon request is rejected and this message is 
displayed: 


NO TIME LEFT 


Processor time can be limited for each account by specifying the 
maximum time the total number of terminal users assigned to that 
account can use time on a processor. In multiprocessing systems, 
processor time includes the total time used on the _ central 
processing unit (CPU) and any auxiliary processing unit (APU) 
assigned to the _ task. Whenever a terminal user's task 
terminates, this limit is checked. If the terminal user has used 
all of the remaining processor time specified for that account, 
this message is displayed: 


YOUR PROCESSOR TIME HAS EXPIRED 


If a terminal user tries to load a task assigned to an account 
with no processor time left, this message is displayed: 


TIME-ERR 


3.3 BUILDING AND STARTING THE AUTHORIZED USER UTILITY 


The Authorized User Utility supplied with the package has_ been 
linked according to the sequence of Link commands shown below. 
User involvement is only necessary when additional Link options 
are required. In that case, the user must specify the necessary 
option and relink the task. See the OS/32 Link Reference Manual 
for more information. 


L .BG,LINK 
T .BG 
ST 


TITLE ACTUTY 
ESTABLISH TASK 
MAP ,ADDR 

INCL ACTUTY .OBJ 
BUILD ACTUTY 
END 
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The following starts the Authorized User Utility. 


Format: 
CREATE 
COMMAND 
START, =fd,, LIST=fd2 , UPDATE >=fd, [, ACCOUNTS=n ] 
CMD 
REPORT 
Parameters: 
COMMAND= file descriptor (fd;) indicates the device or 
file from which command input will come. The 
Authorized User Utility assigns the command 
input device to logical unit 1 (lull). The 
COMMAND parameter can also be entered as C or 
CMD. 
LIST= fda indicates the device or file to which the 


output is sent. The Authorized User Utility 
assigns the list device to 1lu3. 


CREATE specifies a mode of operation for the 

UPDATE= | Authorized User Utility. The AUF to be 

REPORT created, updated or about which a report 
is needed, is specified by fd3. The 
Authorized User Utility assigns the specified 
AUF to lu3. 

ACCOUNTS=n n is a decimal number (O through 65,535) 
indicating the maximum number of accounts 
allowed in the AUF specified by fds3. In the 


CREATE mode, n indicates the size of the new 
AUF . In the UPDATE mode, n indicates the size 
to which the AUF is to be extended. If the 
ACCOUNTS parameter is not specified, the 
maximum number of accounts in the AUF defaults 
to 255 or the maximum set by a previous 
ACCOUNT command. This parameter is ignored 
when the AUF is operating in the REPORT mode. 


Functional Details: 


When the CREATE mode is selected, the Authorized User Utility 
allocates, assigns and initializes the new file specified by fd3. 
If the file specified by fd3 already exists, an error message is 
generated and the Authorized User Utility goes to end of task. 
If the UPDATE mode is selected, an update to the file specified 
by fdgz is requested. If the REPORT mode is selected, a report of 
the file specified by fd3 is requested. If the specified file 
does not exist for the UPDATE and REPORT modes, an error message 
is generated and the utility goes to end of task. 


48-023 FOO RO3 35 


The Authorized User Utility assigns all logical units based on 
the parameters specified in the START command. These starting 
parameters can be entered in any order. The user cannot assign 
specific logical units. 


Examples: 

The following example creates an AUF named NEWFILE. The system 
console (CON:) is the command input device and the line printer 
(PR:) is the list device. Until the START command is issued, 
the file (NEWFILE) does not exist. The Authorized User Utility 


allocates, assigns and initializes the new file for accounts 1 to 
511. 


START, CMD=CON: ,LIST=PR: , CR=NEWF ILE,AC=511 


The next example specifies the console (CON:) as both the 
command input device and the list device. The mode of operation 
is UPDATE an existing file called AUFILE. 


START, UP=AUF ILE, CMD=CON: , LIST=CON: 


3.4 AUTHORIZED USER UTILITY COMMANDS 


The Authorized User Utility commands are: 


@ ACCOUNTS 


@ ADD 

e CHANGE 
e DELETE 
e END 

e LIST 

@ MODE 

e@ PAUSE 


@e@ PRIVILEGE 


e TOTAL 
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The Authorized User Utility has three modes of operation: 
create, report and update. Each mode allows certain Authorized 
User Utility commands to be executed (see Table 3-1). 


@ The create mode is used to establish a new AUF. 
e The report mode allows an account record to be listed or an 
accounting report for each active account (an account record 


already assigned whether used or not) to be generated. 


e The update mode allows account records to be added, deleted, 
modified or listed. 


TABLE 3-1 AUTHORIZED USER UTILITY MODES 
AND ALLOWABLE COMMANDS 


MODES 
| COMMANDS | CREATE | REPORT | UPDATE | 
| ACCOUNTS | 0 * fH fF | 
(ADD TY UT 
) CHANGE =} * fT 
| DELETE =} * {| {| * | 
CC 
eo 
| LIST i x H * x | 
;MODE i} FT| 
| PAUSE =} * GRE 
| PRIVILEGE | * } 0 *® | 
! TOTAL =} GE | 


oe oe ee ee ee ee ee ee ee ee ee ee fee eet ee) em ee ewe wins cme fee ee ee ee ee ee ee ee ee ee ee ere ee 


* Command can be executed in 
specified mode 


** Display (no operand) form only 
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{ ACCOUNTS | 


3.4.1 ACCOUNTS Command 


The ACCOUNTS command raises or lowers the account number § limit 
for the AUF. This command also displays the current limit set 
for the file. 


Format: 


ACCOUNTS n 


Parameter: 


n is a decimal number’ from 1 to 65,535 
indicating the account number limit of the 
AUF. If n is omitted, the current account 
number limit is displayed. If the value 


specified for n is illegal, the ACCOUNTS 
command is ignored. 


Functional Details: 


In the REPORT mode, this command can be used in display form 
only. The Authorized User Utility sets the account limit in 
blocks of 256 records, one account per record. If mn does not 
specify the last record in a 256 record block (e.g., 255, 1,023, 
etc.), the value of n is raised to the next multiple of 256. For 
example, if n=100, the account limit is set to 255. 


After the ACCOUNTS command is executed, the following message is 
sent to the console: 


ACCOUNT LIMIT = n 


The variable n is the current maximum account number to which the 
AUF has been raised or lowered. If the ACCOUNTS command is 
entered without a value specified for n, this message will 
display the current account number limit in the AUF. 
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Examples: 


ACCOUNT 
ACCOUNT LIMIT 


Acc 1000 
ACCOUNT LIMIT 


48-023 FOO RO3 


2047 


1023 


3.4.2 ADD Command 


The ADD command establishes an account to the AUF. 


Format: 


signont ime processortime 
ADD actno,groupno, password, [user id] ' r 


[privi leges] 
Parameters: 


actno 


groupno 


password 


userid 


signont ime 


x x 


is a decimal number from 1 to the current 
account limit specifying the account number to 
be established. 


is a decimal number from 1 to the current 
limit (except 255) specifying a group account 
number to which the private account number is 
to be assigned. Group number 255 is valid 
only as a group number for account 255. 


is a l- to 12-character alphanumeric’ string 
specifying the password to be established for 
the account. 


is a l- to 20-character alphanumeric’ string 
specifying the account user's identification. 


is a decimal number specifying the number of 
seconds of signon time to which the account is 
limited. If an asterisk (*) is specified, no 
limit is applied. For convenience, this 
parameter may be entered in any of the 
following formats: 

e hh:mm:ss 

® mm:ss 

@® seconds 


For example, 1:30:10, 90:10 and 5410 all 
represent the same limit. 
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processortime is a decimal number specifying the processor 
time (CPU+APU) to which the account user is 
limited. If this parameter is omitted, the 
default established at MTM system generation 
(sysgen) is used. If an asterisk (*) is 
specified, no Limit is applied. This 
parameter may be entered in the same formats 
as signontime. 


privileges is a hexadecimal number specifying the 
privileges to be allowed for users signed on 
under this account. If this parameter is not 


specified, the default privileges O0O00A800 
(RENAME, ENVIRONMENT AT SIGNON and PRIVATE CSS 
EXECUTION) are assigned to the account. See 
Section 3.4.9 for information on account 
privileges and their corresponding hexadecimal 
codes. 


Functional Details: 


This command cannot be used in REPORT mode. The account added to 
the AUF must be inactive. If the account number is active, an 
error message is generated and the existing record is not 
changed. The Authorized User Utility mode must be CREATE or 
UPDATE. A copy of the record is written to the log device. 


Account 255 must be added when the AUF is first created. A 
warning results if account number 255 does not exist when the 
Authorized User Utility is terminated. 


The privileges for account 255 are set to FFFFFFFF regardless’ of 
the privileges specified when account 255 is established. 


Example: 


The following ADD command adds a new account to the AUF with the 
following information: the account number is 1000, the group 
number is 250, the password is RAY, the userid is DEPT 2, the 
signon time limit is 9999:59:59, and no processor time limit is 
set. The privileges in effect are SVC6 COMMUNICATION, CHANGE 
PASSWORD, PRIVATE CSS EXECUTION, TEMPORARY and SPOOL FILES, 
ENVIRONMENT AT SIGNON and RENAME. 


ADD 1000,250,RAY,DEPT 2,9999:59:59,*, 8000F800 
1000 250 DEPT 2 9999:59:59 ae 8000F800 03/03/83 
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3.4.3 CHANGE Command 


The CHANGE command changes fields in the AUF record of an active 


account. 


Format: 


* 


signontime 
CHANGE actno, [groupno], [password], [user id] , 


i 


Parameters: 


actno 


groupno 


password 


userid 


signontime 


processortime 


x 


t] {,privileges] 


is a decimal number from 1 to the current 
account limit specifying the account number to 
be changed. 


is a decimal number from 1 to the current 
account limit (except 255) specifying the 
group number to which the account is to be 
assigned. Group number 255 is valid only as 
a group number for account 255. 


is a l- to 12-character alphanumeric’ string 
specifying the password for the account. 


is a l- to 20-character alphanumeric’ string 
specifying the user's identification for the 
account. 


is a decimal number specifying the additional 
signon time to which a terminal user is 
limited. If an asterisk (*) is specified, the 
currently established limit is changed and no 
Limit is applied. For convenience, this 
parameter can be entered in any of the 
following formats: 
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e hh:mm:ss 

® mm:ss 

@ seconds 

For example, 1:30:10, 90:10 and 5410 all 
represent the same limit. 


processortime is a decimal number specifying the additional 
processor time to which the terminal user is 


limited. If an asterisk (*) is specified, the 
currently established limit is changed and no 
limit is applied. This parameter can be 


entered in the same formats as signontime. 


privileges is a hexadecimal number specifying the 
privileges to be allowed for users signed on 
under this account. See Section 3.4.9 for 
information on the account privileges’ and 
their corresponding hexadecimal codes. The 
privileges for account 255 default to FFFF 
FFFF. 


Functional Details: 


This command cannot be used in REPORT mode. As each record is 
changed, a copy of the original and resultant record is sent to 
the list device. 


The values of signontime and processortime are added to the 
current signontime and processortime limits in the AUF to 
increase the time allocations. In a Model 3200MPS System, 
processortime is equal to the additional CPUtAPU time to which 
the terminal user is limited. To decrease the time allocation, 
precede signontime or processortime with a minus sign (-). An 
asterisk (*) causes the limit to be disabled. 


Example: 


The following CHANGE command changes the processor time limit for 
account number 1000 from unlimited processor time to a limit of 
1:30:10. 


CH 1000,,,,,5410 
1000 250 DEPT 2 9999359259 x 8000F800 03/03/83 
1000 250 DEPT 2 9999:59:59 1:30:10 8000F800 03/03/83 
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3.4.4 DELETE Command 


The DELETE command makes an active account inactive. 


Format: 


DELETE actno 


Parameter: 


actno is a decimal number from 1 to the current 
account limit (except 255) specifying the 
account number to be made inactive. 


Functional Details: 
This command cannot be used in REPORT mode... A copy of the 
deleted record is written to the list device. 


Examples: 


The following DELETE command deletes account number 207. 


DEL 207 
207 205 308503154TEMP SHOBER** aes A800 02/18/83 


The following command attempts to delete an inactive account. 


DEL 207 
*** ACCOUNT NUMBER 207 WAS INACTIVE 


3-14 48-023 FOO RO3 


3.4.5 END Command 

The END command closes all logical units and terminates the 
Authorized User Utility. 

Format: 


END 


Functional Details: 


If the Authorized User Utility is ended and account 255 does not 
exist, the Authorized User Utility issues a warning that the user 
has created an AUF that cannot be accessed later. 


Example: 
END 
** WARNING ACCOUNT 255 DOES NOT EXIST 
LAURIE -END OF TASK CODE= 0 PROCESSOR=9: 43:33:04 TSK-ELAPSED=10:30:34 | 
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3.4.6 LIST Command 


The LIST command displays active account records to the list 
device. 


Format: 


List actno,|; actno,] | 


Parameters: 


actno, is a decimal number from 1 to the current 
account limit specifying the account numbers 
to be displayed to the list device. If used 
in conjunction with actno,, it specifies the 
beginning of a range of account numbers to be 
displayed to the list device. 


actno, is a decimal number from 1 to the current 
account limit specifying the end of a range of 


account numbers’ to. be displayed to the list 
device. 


Functional Details: 


When no account number is specified, all active accounts) are 
listed. When only actno,; is specified, only actno; is listed. 
When two account numbers are specified, all account numbers’ from 
the first account number to the second account number are listed. 


Examples: 
In the following example, a single account is listed. 


LIST 1000 


PROCESSOR 
ACT GRP NAME TIME LEFT TIME LEFT PRIV DATE 
1000 250 DEPT 2 9999:59:59 ae 8000F800 03/03/83 
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A range of accounts is listed 


LIST 200,1000 


ACT GRP 
201 205 
207 205 
211 205 
230 230 
1000 250 
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NAME 
308503154TEMP SHOBER 
308503154TEMP SHOBER 
308503154TEMP SHOBER 
035713087CAROL, CARCH 
DEPT 2 


in the following example. 


TIME LEFT 


xx 
xx 
xx 
*x 


9999:59:59 


PROCESSOR 


TIME LEFT 


xx 
KK 
Kx 
xx 


1:30:10 


PRIV 
OOO0A800 
0000A800 
0000A800 
OO00A800 
8000F 800 


DATE 
02/18/83 
02/18/83 
02/18/83 
02/18/83 
03/03/83 


3.4.7 MODE Command 
The MODE command displays the current mode, changes the current 


mode of the Authorized User Utility, or reassigns or creates an 
AUF . 


Format: 


CREATE 
MODE | <UPDATE [=£45 | 


REPORT 


Functional Details: 
The MODE command with no parameters displays the current mode. 
When a mode is specified, the mode is reassigned but the AUF is 


not changed. When fd3 is specified, the mode is changed and the 
AUF is reassigned. 


When the create mode is specified, an error message is generated 
if fds exists. The Authorized User Utility allocates the new AUF 
and initializes it for the number of account records currently in 
effect. 


Examples: 


To place the Authorized User Utility in the REPORT mode: 
>MODE REPORT 
To display the current mode: 


»M 
es REPORT IS THE CURRENT MODE 
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3.4.8 PAUSE Command 

The PAUSE command pauses the Authorized User Utility and 
transfers control to the operating system. If the Authorized 
User Utility is running under MTM, control is transferred to MTM. 


The CONTINUE command returns control to the Authorized User 
Utility. 


Format: 


PAUSE 
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3.4.9 PRIVILEGE Command 


The PRIVILEGE command can be used to change or 
privileges for an account or range of accounts. 
Format: 
privilege 
PRIVILEGE | actno, Factnop}] F 
x 

Parameters: 

actno, is a decimal number from 1 to 


display the 


the current 


account limit specifying the account number or 
the start of a range of account numbers of 
which the current privileges are to be changed 


or displayed. If this parameter 


is omitted, 


the default is all currently active accounts. 


actnoo2 is a decimal number, from actno; 
current account limit, specifying the final 
account number of the range to be changed or 


displayed. 


privilege is the hexadecimal mask of the 
be assigned to the specified account or range 
of accounts. If an asterisk (*) is specified, 
the default privilege OOOOA800 


this parameter is omitted, 


+ 1 to the 


privileges to 


is used. If 
the current 


privileges of the specified account or range 


of accounts are displayed. 
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HEX MASK | 


8000 0000 ; 


0800 0000 


0400 0000 


0080 0000 


48-023 FOO RO3 


TABLE 3-2 MTM ACCOUNT PRIVILEGES 


PRIVILEGE AND DESCRIPTION 


Supervisor call 6 (SVC6) Communication - 
allows the user to load a task with task 
communication enabled. If a user without 
this privilege loads a task with the SVC6 
communication option, MTM disables the 
option when the task is loaded. 


E-task - allows the user to load executive 
tasks (e-tasks). If a user without this 
privilege attempts to load an e-task, an 
error message is generated and the task is 
not loaded. 


SVC6, logical processing unit (LPU) and APU 
Control - allows a user to load tasks with 
SVC6 control enabled. At load time, MTM 
checks the task's requested options against 
the user's privileges. If MTM discovers 
that the user does not have the SVC6 control 
privilege requested by the task, MTM dis-— 
ables the option at load time. If this 
option is set, the user may load a task with 
an LPU number other than O or may use the 
OPTIONS LPU=n and OPTIONS NLPU command. The 
user may load tasks with APC and APM options 
set (SVC13) at link time. If a user without 
this privilege loads a task, MIM resets the 
task LPU number to 0 (issuing a warning to 
the console) and disables the APC and APM 
options upon loading the task. 


Extended Account Access —- allows the user to 
enter an account number in addition to a 
class in an fd. This extended access is 
allowed for the commands RENAME, ASSIGN and 
LOAD, and for command substitution system 
(CSS) calls. File access is limited to 
shared read-only (SRO) for accounts other 
than the user's private account. Without 
this privilege, a user can only enter file 
classes in an fd; i.e., P, G, S. 


BIT 
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TABLE 3-2 MTM ACCOUNT PRIVILEGES (Continued) 
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HEX MASK | PRIVILEGE AND DESCRIPTION | BIT 
0040 0000 } Set Group - allows the user to change the ; 9 


{ f 
{ group account number of an account via the H 
| SET GROUP command. If a user without this t 
{| privilege attempts to use the SET GROUP H 
{ command, an error message is generated. The | 
{ user's new group account number is retained | 
{ until signoff or until changed by another H 
| SET GROUP command. The user's group number | 
| is not changed in the AUF. No user may set | 
{ a group account to 255. H 
| Task Account Privilege - allows the user to j; 
| load tasks with the account privilege task H 
| option enabled. If a user without this { 
| 1 
| | 


privilege attempts to load a task requesting 
this option, MTM disables the option. 
| Bare Disk Access - allows the user to access } 
| bare disks for tasks that have this option i 
| enabled. Users requesting the bare disk H 
] ’ 
' 4 


option without this privilege will have the 

option disabled by MTM. 
| Universal Tasks - allows the user to run { 
| tasks as universal tasks. If a user without } 
|} this privilege attempts to run a task with { 
1 ! 
| ! 
! ’ 
| j 


the universal option enabled, MTM disables 

the option and the task is run as a user- 

task (u-task). 
| Environment at Signon - permits the use of H 
| the ENV= parameter of the SIGNON command. If | 
{| a user without this privilege tries to use H 
| the ENV= parameter, MTM ignores the environ- | 
| i 
! ! 


ment request and forces the USERINIT.CSS to 
be executed. 
| Temporary and Spool Files - permit a user to } 
| Gisplay the filenames of temporary and spool |} 
| files. If a user without this privilege H 
| ’ 
| ! 


attempts to display temporary or spool file 
fds, MTM returns *TEMPFILE* and *SPOOLFILE*. 
{| Private CSS Execution - permits a user to i 
; execute private CSS files. A user without i 
| this privilege is limited to system CSS H 
| calls. H 
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TABLE 3-2 MTM ACCOUNT PRIVILEGES (Continued) 
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HEX MASK | PRIVILEGE AND DESCRIPTION | BIT 
0000 1000 |} Change Password - permits a user to select a } 19 

} new password via the PASSWORD command. The | 

} new password is entered in the AUF and H 

} remains in effect until changed by another 

| PASSWORD command or the Authorized User { 

|} Utility. An error message is generated for |} 

; users without this privilege attempting to |} 

} use the PASSWORD command. 
{ OOOO 0800 } Rename - permits a user to rename private H 
| Files to group or system files; i.e., G, S. | 
\ | If a user also has the EXTENDED ACCOUNT i 
H | ACCESS privilege, private files may be { 
| } renamed to any account. Users without this H 
H | privilege may rename files only within their |; 
H | private accounts. ' 
Wi ces ets ie iim Vn em’ Gma onan “emesis cms" cmc cc “ci hs “cao cl mses ai uv me cee Ss elt ci im ems hs i me ele "a ‘es 
{ 0000 0400 |} Priorities 1 to 11 - permit a user to. H 
H { employ the PRIOR command in a private CSS H 
H | to set a task's priority within the range of | 
H | »«MTM+1 to .MTM+tll. The maximum priority 
H ; available to users without this privilege is | 
| 1 .MTM+12. Priorities .MTM+tl to .MTM+1ll are { 
{ | always available to system CSS calls regard- |; 
{ | less of a user's privileges. H 
0000 0200 } Batch Priority - allows a user to raise the jj; 
{ priority of a batch job above the default H 
{| priority. The default priority for batch { 
{ tasks is .MTM+12+SGN.PRIO. Batch priorities | 
{ can be raised through the use of the SUBMIT | 
{ and PRIOR commands. The priority of a batch | 
{ task can never be raised above the priority | 
| of interactive tasks (.MTM+l12), but users H 
| may lower batch priorities regardless of { 
{ their privileges. 
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TABLE 3-2 MTM ACCOUNT PRIVILEGES (Continued) 


HEX MASK 


00 0100 


oO ll 
Ol 


0000 0040 


0000 OOOF 


PRIVILEGE AND DESCRIPTION 


ss SS SSS SS SS SS SS SS SSS SS SS SS SS SS SSS OS ss SS Ss Se es 2 ee es Ss SS SS ee 


| Privileged User (Unlimited File Access) - 
allows a user unlimited access to all 
accounts except 255. Users with this 


privilege may enter the SET PRIVATE command 


to change their account numbers. This 
allows users to access the files of any 
account as if they were the user's private 
files; knowledge of the account's password 


t 

| is unnecessary. This privilege also allows 
} users to change their group account numbers. 
| The user retains all privileges from signon 
! 


time when moving among accounts; the 
privileges of the account being accessed 
by a privileged user are ignored. 


This privilege also provides the user with 
the ability to display all batch jobs in the 


system through the INQUIRE command. 
Through the DISPLAY FILES command entered 


with an * in the account field, a user can 


display files in all accounts. 


! 
! 
i} $FOREGROUND interface. If a user without 
| this privilege attempts to connect toa 

| foreground task, an error message is 
} generated. 


| HASP Interface - allows the user to inter- 
| face with HASP tasks in the system. 

| SGN.$HSP must be enabled at MTM sysgen to 
| permit this privilege. A user without this 
{| privilege who attempts to connect witha 

| HASP task receives an error message. 


There are 15 (0 to F) possible accounting 


user classes. Each account must be assigned 
to an accounting user class. Each accounting 
class corresponds to a set of processor and 


the UPRCLIM and UIOLIM macros at MTM sysgen. 
If limits for each class are not established 


through UPRCLIM and UIOLIM, the limits set 
by PRCLIMIT and IOTAB apply, and all 
accounts effectively belong to the same 


| input/output (1/0) limits as specified by 
' 
: 
| 
| 
H 
; accounting user class. 


Foreground Interface - allows the use of the 


Accounting User Classes - is used to specify 
an accounting user's class for each account. 
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Examples: 


In the following example, the privileges of a single account are 


listed. 
PRIV 1000 
ACT NAME PRIV 
1000 DEPT 2 8000F 800 


In the following example, the privileges of a range 
are changed to the default privileges. 


PRIV 200--1000, * 


ACT NAME PRIV 

201 308503154TEMP SHOBER OO000A800 
211 308503154TEMP SHOBER O0000A800 
230 035713087CAROL CARCH 0000A800 
1000 DEPT 2 OOO0A800 


In the following example, the privileges of an 
changed. 


PRIV 1000,FFFFFFFF 
ACT GRP NAME PRIV 
1000 250 DEPT 2 FFFFFFFF 
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of accounts 


account are 


3.4.10 TOTAL Command 


The TOTAL command generates a report to the list device or resets 
the values in the signon time used and processor time used fields 


to 0. 
Format: 
TOTAL [c ] 


Parameter: 


Cc is an alphabetic character specifying that the 
signon time and processor time used fields are 
to be cleared or reset to 0, and no report is 
to be generated to the list device. If this 
parameter is omitted, a report is generated to 
the list device and no values are cleared or 


reset to O. 


Functional Details: 


The generated report lists each active account. The following 
details concerning each account are displayed: account number, 
group number, signon time left, processor time left, and the 
processor and signon time used since the last report was 


generated. 
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TOTAL 
ACT GRP NAME 
1 1035213065DCF GROUP 
10 18030503089DC CONSULTA 
13 103521306S5CHUCK PECK 


16 18031183089B0B DOMITZ 
18 18031183089WILL ETZ 

20 200357030850S32MT GROU 
23 1035213065CHRIS ARCHE 
29 180362430870S53 

33 18030493086N SHKOLNIKO 
34 20032453088ADMINISTRAT 
35 18032373086RANDEE HAFT 
36 20031543085PETE HORN 
45 1035203065JOHN GRAY 
53 96036243087LANCE PATTI 
57 18031203089SUE SELBY 
58 1035203065BILL DEIBLE 
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TIME LEFT 


PROCESSOR 
TIME LEFT 


xx 
xx 
xx 
x * 
x* 
xx 
“xX 
xx 
KK 
xx 
xx 
xx 
xx 
xx 
xx 
xx 


PRIV 


0000A800 
0000A800 
8000FCOF 
8000FCOF 
8000FCOF 
8COEFEOF 
8000FCOF 
FFFFFFFF 
8000FCOF 
8CDEFEOF 
8000FCOF 
8000FCOF 
8000FCOF 
8008FCOF 
8000FCOF 
8000FCOF 


TIME USED 


oooooonroeoooo0o°eo 7000 


PROCESSOR 
TIME USED 


oooocoorcec0e°0eooeowodo 


CHAPTER 4 
OS/32 ACCOUNTING FACILITY 


4.1 INTRODUCTION 


The OS/32 Accounting Facility is a software feature that is 
optionally specified at OS/32 system generation (sysgen). This 
facility provides the user with management information for 
computer center operation. Information is collected on the basis 
of account numbers and user identifiers (userids), and is 
reported as a formatted summary on user-selected account numbers 
and time periods. The collected information includes such items 
as processor (PRC) time, auxiliary processing unit (APU) time, 
size of a task's segments, elapsed time, roll time, wait time, 
input/output (1/0) counts to I/O devices, and system space usage. 
Because data collection is performed by the operating system and 
the multi-terminal monitor (MTM), an operating system and MTM 
sysgen are required and should be consistent for both. 


The Accounting Facility is composed of two parts: 


@e Data collection 


@e Reporting Utility 


Data collection is performed by the operating system and MTM 
through counting, collecting and logging routines, which together 
collect and store the accounting information in a user-specified 
disk file called the accounting transaction file (ATF). 


The Reporting Utility is a utility program that selects and 
transfers accounting information to a printer, disk file or tape 
file. Through operator-specified commands , accounting 
information can be used to produce cost distribution, billing, 
control and information reports. See the OS/32 Systems Support 
Utilities Reference Manual. 
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4.2 SYSTEM REQUIREMENTS 


The Accounting Facility requires these system components: 


@ Perkin-Elmer 32-bit processor. 

@ 256kb memory 

@ OS/32 RO7.2 software release or higher 
e Accounting support at OS/32 sysgen 

e Accounting support at MTM sysgen 

e Disk device 

e Print device 


e Temporary files 


4.2.1 0S/32 System Generation (Sysgen) 


The Accounting Facility is included in the OS by specifying the 
sysgen ACCOUNTING and IOCLASS configuration input commands. See 
the OS/32 System Generation (Sysgen/32) Reference Manual. 


4.2.2 Multi-Terminal Monitor (MTM) System Generation (Sysgen) 


The Accounting Facility is included in MTM through the parameter 
specified for the OS/32 Accounting Facility option (SGN.ACT) at 
MTM sysgen as described in Chapter 2. 


4.2.3 Accounting Transaction File (ATF) 


The ATF contains records for all activities performed by each 
account. The information processed by the Reporting Utility is 
provided by the ATF. The ATF is created by MTM through the ATF= 
parameter of the MTM START command (see Chapter 5). The ATF can 
also be changed by MTM through a parameter in the .MTM operator 
command. When the command .MTM ATF file descriptor (fd) is 
. entered, the current ATF is closed and a new ATF is opened. This 
allows data collection to continue on the new ATF while the 
Reporting Utility processes the accounting data in the old ATF. 
If a new ATF is not opened, an assignment error is displayed and 
data can no longer be collected. 
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4.3 LINK OPTION 


Accounting support can be enabled or disabled for tasks through 
an optional parameter in the Link OPTION command (see the 0S/32 
Link Reference Manual). 


4.4 STARTING DATA COLLECTION 


After operating system and MTM sysgens with accounting support 
have been performed, MTM is started as described in Sections 5.2 
and 5.3. Data collection is started by specifying the ATF= 
parameter of MTM START command. 


4.5 DATA COLLECTION 


The OS/32 Accounting Facility collects data for each account. 
All collected data is stored in the appropriate ATF records on 
the basis of a job or task. Job-related data is collected on the 
total number of tasks submitted as one job. Task-related data is 
collected on a single task. Job- and task-related data are 
collected and stored in specific categories which are explained 
in the following sections. 


See Appendix D for ATF record formats. 


4.5.1 Accounting Date and Time Formats 


Accounting dates are specified and displayed by MIM in these 
formats: 


mn/dd/yy is the month, day and year displayed on the 
terminal user's console when the terminal user 
signs off the system. 


mon/dd/yy is the month (three alphabetic characters), 
day and year specified in the Reporting 
Utility SELECT, OPTION and REPORT commands 
(see the OS/32 System Support Utilities 
Reference Manual). 


ad/mon/yy is the day, month (at least three alphabetic 
characters) and year specified in the 
Reporting Utility SELECT, OPTION and REPORT 
commands (see the OS/32 System Support 
Utilities Reference Manual). 
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Accounting times are displayed by MTM in these formats: 


a. hh:mm:ss 


is the hours, minutes and seconds of 
elapsed time, task elapsed time, 
signon time left or signoff time. 


b. hh:mm:ss.ms pp.p% is the hours, minutes, seconds, 


milliseconds (ms) and percentage of 
total elapsed time of user central 
processing unit (CPU) time, wait 
time, roll CPU time, supervisor call 
(SVC) CPU time, total processor time 
or total processor time left. In a 
Model 3200MPS System, the user APU 
time is displayed in this format. 


The following displayable accounting times and their formats are 
specified: 


user CPU time 


SVC CPU time 


roll CPU time 


user APU time 


processor time 


task elapsed 
time 


signoff date 
and time 


elapsed time 


total task 
elasped time 


total 
processor 
time 


is the CPU time spent directly by the user 
task; format b. 


is the CPU time spent for SVCs on behalf of a 
user task; format b. 


is the CPU time spent to roll the user's task; 
format b. 


is the APU time spent by the user task _ (on 
Model 3200MPS only); format b. 


is the total processor time spent by or on 
behalf of the user task (= user CPU + SVC CPU 
+ roll CPU + user APU); format b. 


is the time between start and end of task; 
format a. 


is the date and time, in the appropriate 
format, of the terminal session or batch job 
signoff; format a. 


is the time between signon and signoff for 
a terminal session or batch job; format a. 


is the task elapsed times accumulated between 
signon and signoff for a terminal session 
or batch job; format a. 


is the processor time accumulated between 


signon and signoff for a terminal session or 
batch job; format b. 
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signon time is the amount of time left for the terminal 
left user or batch job out of the allocated limit; 


format a. 


processor time is the amount of processor time left for the 


left terminal session or _ batch 


allocated limit; format b. 


4.5.2 Terminal Session or Batch Job Accounting Data 


out of the 


The accounting data collected for each terminal session or batch 


job processed is: 


@e Elapsed time 

@e Signon and signoff date and time 
e Job number 

@e Date and time a job is submitted 


@e Total number of tasks run 


e Total number of command substitution system 


executed 


e Total number of commands entered 


@ Total number of DISPLAY FILES commands entered 


e User identifier (userid) 
e Renamed and deleted files 


e Account number 


All job-related accounting data is described 
sections. 


4.5.2.1 Elapsed Time 


(CSS) calls 


in the following 


Elapsed time is the amount of time that passes between signon and 
signoff for a particular terminal session or batch job. Elapsed 
time is displayed as a message on the terminal user's console or 


batch log device each time the terminal user or batch 


off: 


ELAPSED TIME = elapsed time 
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job signs 


4.5.2.2 Signon and Signoff Date and Time 


The signon and signoff dates and times indicate the dates and 
times that the terminal user or batch job signs on and off the 
system. These dates and times are collected and stored as 
hexadecimal numbers in the ATF signon and signoff account 
records. Signon and signoff times are collected and stored in 
the ATF signon and signoff account records as the current time to 
the nearest minute. 


The signoff date and time are displayed as a message on the 
terminal user's console or batch log device each time the 
terminal user or batch job signs off. 


TIME OFF = signoff date and time 


4.5.2.3 Job Number 


The job number is a hexadecimal number assigned to a job 
consisting of one or more tasks. This number is collected and 
stored in the ATF signon, signoff and task completion or data 
overflow account records. 


4.5.2.4 Date and Time a Job is Submitted 

The date and time a job is submitted to the batch queue is 
collected and stored as a hexadecimal number in the ATF signon 
account record. 

4.5.2.5 Total Number of Tasks Executed 

The total number of tasks executed as part of a batch job or 


during a terminal session is collected and stored as a 
hexadecimal number in the ATF signoff account record. 


4.5.2.6 Total Number of Command Substitution System (CSS) Calls 
Executed 

The total number of CSS calls executed by a batch job or during 

a terminal session is collected and stored as a hexadecimal 

number in the ATF signoff account record. 

4.5.2.7 Total Number of Commands Entered 

The total number of commands entered in the system by a batch job 


or during a terminal session is collected and stored as a 
hexadecimal number in the ATF signoff account record. 
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4.5.2.8 Total Number of DISPLAY FILES Commands Entered 

The total number of DISPLAY FILES commands entered in the system 
by a batch job or during a terminal session is collected and 
stored as a hexadecimal number in the ATF signoff account record. 
4.5.2.9 User Identifier (Userid) 

The userid, with which the terminal user or batch job signs’ on 
the system, is collected and stored in the ATF signon, signoff 
and task completion or data overflow account records. 

4.5.2.10 Renamed and Deleted Files 

Data pertaining to files that are renamed or deleted is collected 
and stored in the ATF renaming or deletion account records. This 
data consists of the: 

e Date and time the file was created 

e Current fd 

@e Number of sectors in the file 

@ Date and time the file was renamed 


e New fa 


@ New account number to which the file was assigned 


4.5.2.11 Account Number 

The account number with which the terminal user or batch job 
signs on the system is collected and _ stored in all the ATF 
account records. 


4.5.3 Task-Related Accounting Data 


The accounting data collected for each task processed is: 


@e User CPU time, SVC CPU time and roll CPU time 
@ User APU time (Model 3200MPS System only) 

@® Roll time 

@ Wait time 


e Date and time a task started and terminated 
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e Userid 

@ Memory used 

e Count of I/0 transfers to I/O devices 

@ Roll count 

e fd from which a task was loaded 

® User-supplied information 

e® Account number 

e Job number 

e End of task code 

All task-related accounting data is described in the following 
sections. 

4.5.3.1 Processor (PRC) Time 

Processor time is collected and stored in the ATF task completion 
or data overflow account records as a number of 100ms increments. 
All processor time is collected and stored in the _ following 
categories: 

@ User CPU time 

e Svc CPU time 

@ Roll CPU time 

@ User APU time 

User CPU time is the amount of CPU time spent executing user code 
and nonreentrant system code. SVC CPU time is the amount of CPU 
time spent executing reentrant system code on behalf of the user. 
Roll CPU time is the amount of CPU time spent rolling a task into 
memory. User APU time is the time spent executing user code on 
an APU in a Model 3200MPS System. Processor time (user CPU +t 
user APU + SVC CPU + roll CPU) is displayed as a message on the 
terminal user's console or batch log device. The following 


message is displayed when a terminal user's task or batch job 
terminates: 


taskid-END OF TASK CODE=xxxx PROCESSOR=processor time TSK-ELAPSED=task elapsed time 
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The following message is displayed when data overflow occurs: 


taskid-ACCOUNTING DATA RESET PROCESSOR=processor time TSK-ELAPSED=task elapsed time 


The following message is displayed when the terminal user or 
batch job signs off: 


PROCESSOR=total processor time TSK-ELAPSED=total task elapsed time 


The user CPU, SVC CPU, roll CPU and user APU times can also be 
displayed by the DISPLAY ACCOUNTING command (see the 0S/32 
Multi-Terminal Monitor (MTM) Reference Manual). 


4.5.3.2 Roll Time 


Roll time is the time a task spends waiting to execute because it 
was rolled out of memory. All roll time is collected and stored 
in the ATF task completion or data overflow account records as a 
number of 100us increments. Roll time can be displayed by the 
DISPLAY ACCOUNTING command (see the OS/32 Multi-Terminal Monitor 
(MTM) Reference Manual). 


4.5.3.3 Wait Time 


Wait time is the time a task spends waiting to execute because of 
a request that task issued for itself (e.g., I/O request). Wait 
time excludes all PAUSE requests and the time a task spends 
suspended by another task or by the terminal user. All wait time 
is stored in the ATF task completion or data overflow account 
records as a number of 100ms_ increments. Wait time can be 
displayed by the DISPLAY ACCOUNTING command (see the 05/32 
Multi-Terminal Monitor (MTM) Reference Manual). 


4.5.3.4 Date and Time a Task Started and Terminated 

The date and time a task started and terminated is collected and 
stored in the ATF task completion or data overflow account 
records as a number of 100ms increments. 

4.5.3.5 User Identifier (Userid) 

The userid, with which the terminal user or batch job signs on 


the system, is collected and stored in the ATF signon, signoff 
and task completion or data overflow account records. 
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4.5.3.6 Memory Used by a Task 


The total amount of memory used by a task during execution is 
collected and stored in the ATF task completion or data overflow 
account records as the number of 256-byte segments. Memory used 
is collected and stored in three categories: 


e Impure segment space 
e Shared segment space 


e System space 


Impure segment space is the maximum amount of impure memory used 
by a task during execution. Shared segment space is the maximum 
amount of shared memory (i.e., pure, TCOM, RTL) used by a task 
during execution, and system space is the maximum amount of 
system space used by a task during execution. 


4.5.3.7 Count of Input/Output (1/0) Transfers to I/O Devices 


All I/O transfers (read, write, test and set) made to an @=I[/O0O 
device assigned to a particular device class are _ counted, 
collected and stored as a hexadecimal number. in the ATF task 
completion or data overflow account records. These numbers are 


stored in the appropriate class category in the ATF. Each I/O 
class supported by the Accounting Facility occupies eight bytes 
in each ATF account record. The number of bytes’ transferred 


every time an I/O transfer occurs is counted and stored as a 
hexadecimal number in the ATF. The count of I/O transfers can be 
displayed by the DISPLAY ACCOUNTING command. I/0 transfer limits 
are established at MTM sysgen time by the IOTAB or UIOLIM macros 
(see Chapter 2) and can be overridden by the terminal user for 
batch jobs through the SIGNON command (see the 08/32 
Multi-Terminal Monitor (MTM) Reference Manual). 


4.5.3.8 Roll Count 


Roll count is the total number of times the impure segment of a 
task is rolled into memory. The roll count is collected and 
stored as a hexadecimal number in the ATF task completion or data 
overflow account records. The roll count can be displayed by the 
DISPLAY ACCOUNTING command (see the OS/32 Multi-Terminal Monitor 
(MTM) Reference Manual). 
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4.5.3.9 File Descriptor (fd) from Which a Task Was Loaded 


Every time a task is loaded, the fd from which it was loaded is 
stored in the ATF task completion or data overflow account 
records. This data aids the user in determining which system 
tasks are used more often, and whether they should be made 
resident or nonresident. 


4.5.3.10 User-Supplied Information 


User-supplied information is eight bytes of data supplied by the 
terminal user through the SETACCT macro. This information is 
stored in the ATF task completion or data overflow account 
records (see the OS/32 System Macro Library Reference Manual). 


4.5.3.11 Account Number 


The account number, with which the terminal user or batch job 
signs onto the system, is collected and stored in all ATF account 
records. 


4.5.3.12 Job Number 


The job number, to which a particular task is assigned, is 
collected and stored in the ATF signon, signoff and task 
completion or data overflow account records. 


4.5.3.13 End of Task Code 


The end of task code, with which each task terminates, is 
collected and stored in the ATF task completion or data overflow 
account records. The code is displayed on the terminal user's 
console or batch log device each time a user's task or batch job 
terminates: 


taskid-END OF TASK CODE=xxxx PROCESSOR=processor time TSK-~ELAPSED=task elapsed time 


If a task exceeds the processor time limit, the end of task code 
1200 is displayed when the task terminates. If a task exceeds 
the 1/0 transfer limit, the end of task code 1210 is displayed 
when the task terminates. 
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4.6 TERMINAL USER ACCESS TO ACCOUNTING INFORMATION 


A terminal user can access accounting information: 


@e at task termination, 
@ when a task control block (TCB) counter overflow occurs, 
e at signoff time, 


e through the DISPLAY ACCOUNTING command (see the 0S/32 
Multi-Terminal Monitor (MTM) Reference Manual), or 


@ through the fetch accounting information (FETACCT) macro (see 
the OS/32 Multi-Terminal Monitor (MTM) Reference Manual). 


4.6.1 Task Termination 
When a terminal user's task or batch job terminates execution, 


accounting information is displayed on the terminal user's 
console or batch log device in this message: 


taskid-END OF TASK CODE=xxxx PROCESSOR=processor time TSK-ELAPSED=task elapsed time 


4.6.2 Task Control Block (TCB) Counter Overflow 


When the counters for data collection in the TCB' overflow, this 
accounting information is displayed on the terminal user's 
console or batch log device in this message: 


taskid-ACCOUNTING DATA RESET PROCESSOR=processor time TSK-ELAPSED=task elapsed time 


4.6.3 Signoff Time 


When a terminal user or batch job signs off the system, 
accounting information is displayed to the terminal user's 
console or batch log device in these messages: 


ELAPSED TIME=elapsed time PROCESSOR=total processor time TSK-ELAPSED=total task elapsed time 


SIGNON LEFT=signon time left PROCESSOR LEFT=processor time left 
TIME OFF=-signoff date and time 


If there are no signon or processor time limits set for _ the 
account, SIGNON LEFT= and PROCESSOR LEFT= are not displayed at 
signoff. 
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CHAPTER 5 
MULTI-TERMINAL MONITOR (MTM) OPERATING PROCEDURES 


5.1 INTRODUCTION 

Before loading and starting MTM, an authorized user file (AUF) 
must already exist (see Chapter 3). The commands used to load, 
establish, start and control MTM are presented in this chapter. 
5.2 LOADING AND ESTABLISHING THE MULTI-TERMINAL MONITOR (MTM) 
The following two commands load and establish MTM as the current 
task: 


Formats: 


LOAD .MTM,fa 


TASK .MTM 
Parameter: 


fd is the file descriptor of the device from 
which MTM is loaded. 


Functional Details: 


The priority of MTM is established when MTM is linked. To ensure 
that MTM is not at the same level as the real-time system, MT 
should be set at a priority lower than the lowest priority of 
real-time tasks in the operating system. If MTM is set at a 
lower priority, it executes as a background system. Since MTM is 
almost totally input/output (1/0) bound, it does not interfere 
with other tasks. Tasks executing in an MTM environment will run 
at a maximum priority of one less than the priority of MTM. 
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5.3 
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The START command starts MTM. Parameters for the START command 
may be specified in any order. 


Format: 


START ,AUF-fd [,ATF-fd] [,TERMINAL=(fd, [/fd2,---,fdn]) | 
[ ,BATCH=(n,fd)] [; PAGE-fd] 


Parameters: 


AUF = 


ATF = 


TERMINAL= 


BATCH= 


fd is the file descriptor of the AUF. This 
file must reside on account 255. The 
Authorized User Utility must be used to create 
the AUF prior to running MTM. This parameter 
is required. a 


fd is the file descriptor of the accounting 
transaction file (ATF). The ATF accumulates 
accounting data in systems with accounting 


support. If the indicated file exists, 
records are appended. If it does not exist, 
MTM automatically allocates tt: This 


parameter must be specified if the operating 
system is generated with accounting support. 
A user who does not wish to retain accounting 
information can specify ATF=NULL. 


fd is the file descriptor of the terminal 
devices that MTM is to monitor. Up to 64 
terminal fds can be specified. If the command 
line entered exceeds one line, specify 
additional terminal devices with the .MTM ADD 
command. 


n is a decimal number from 1 to 64 indicating 
the number of concurrent batch streams that 
MTM can start. 


fd is the file descriptor of the batch queue. 
The batch queue is an indexed file containing 
fds of the batch streams to be processed. If 
the fd specified does not exist, MTM allocates 
the file. 
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PAGE= fd is the file descriptor of the page file 
used by local and global variables. If this 
parameter is omitted, MTM automatically 
allocates a file nmamed PAGE on the system 
volume, account 255. 


Functional Details: 


The number of concurrent batch streams allowed, plus the ’§ number 
of terminals to be monitored, cannot exceed the maximum number of 
users allowed (NUSERS) at MTM system generation (sysgen). 


MTM can optionally load and start an assistant task (which runs 
under the task name .MTMASST). An assistant task executes a 
supervisor call 7 (SVC7) on behalf of MTM. This task can improve 
MTM response time because MTM does not have to wait while an SVC7 
is in progress. 


When started, MTM tries to load and start the assistant task. 
MTM assumes that the assistant task image is on the file 
MTMASST.TSK on the system volume. If this file does not exist, 
or if the load fails, MTM is not affected. However, MTM issues 
its own SVC7 calls and response time is slower. 


Because the operating system cancels all subtasks when the 
monitor task goes to end of task, .MTMASST is also cancelled when 
MTM goes to end of task. If an attempt is made to restart MIM, 
MTM goes to end of task 254. 


When MTM is started from a command substitution system (CSS) 
file, and an .MTM command immediately follows the START command, 
an SVC6-ERR TYPE=QUE POS=.MTM error may occur. This error 
results if the MTM task has not completed initialization when the 
-MTM command is entered. To avoid this problem, put time delay 
commands such as $WAIT 2 between the START and .MTM commands. 


Example: 
This command starts MTM using an AUF named ACCTS.32/255 and an 
ATF named ATF./255. Three terminals are to be monitored. Four 


batch jobs may run concurrently, and the file BATCH.Q is assigned 
as the batch queue. 


ST,AUF=ACCTS .32,ATF=ATF ,T=(CR10O:,CR12:,CR14:) ,B=(4,BATCH.Q) 
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5.4 .MTM COMMAND 
The .MTM command enables the system operator to control MIM, its 
terminals and users from the system console. 


Format: 


WAIT 
TERMINAL 


STATUS; « BATCH 


USED [,fd1] 


TELM 
userid message 
MESSAGE 


BROADCAST message 


device: 
-MTM ADR 
BATCH n[,fa] 


TERMINATE device: 
device: 

REMOVE 
BATCH n 

QUIESCE 

PURGE fd 

INQUIRE [fad ] 

SUBMIT fad 


ATF fa 
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Parameters: 


STATUS 


WAIT 


TERMINAL 


BATCH 


USED 


fa, 


TELL 


MESSAGE 


userid 


BROADCAST 


message 


ADD 


device 
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displays current information. If no _ further 
parameter is specified, information on 
terminal users and batch jobs is displayed. 


displays to the system console system 
resources available to MTM, the peak usage of 
system resources, and the number of times 


users had to wait for resources to become 
available. 


indicates that terminal information is to be 
displayed. 


indicates that batch information is to be 
displayed. The number of batch streams that 
can run concurrently is also displayed. 


displays in histogram form the number of times 
a command buffer was used during MTM 
execution. See Figure 5-1 for an example of 
a listing output by the USED parameter. 


specifies the file or device to which the 
output from the USED parameter is sent. If 
fd; is omitted, the system console is’ the 
display device. 


displays a message on a specified user 
terminal. 


displays a message on a specified user 


terminal. 
identifies the terminal user. 


displays a message on all terminals whether or 
not they are in use. 


is a l- to 62-character alphanumeric’ string 
indicating the message to be broadcast. 


adds an additional terminal or concurrent 
batch to the MTM system. 


is the new terminal to be added. The total 
number of terminals supported by MT must not 
exceed NUSERS (number of batch streams). 


BATCH n 


fd 


' TERMINATE 


device 


REMOVE 


adevice 


BATCH n 


QUIESCE 


is the number of additional concurrent batch 
streams to be allowed. The total number of 
concurrent batch streams supported by MTM must 
not exceed NUSERS (number of terminals). This 
parameter increases the number of allowable 
concurrent batch streams supported by MTM but. 
does not add batch streams to the batch queue. 
To add batch streams to the batch queue, use 
the SUBMIT command. 


specifies the file descriptor of the batch 
queue file. If a batch queue currently 
exists, this parameter is ignored. 


immediately cancels a terminal user's task and 
signs off a terminal user. This parameter 
does not affect batch jobs. 


is the terminal to which the user to be 
terminated is signed on. 


stops MTM from accepting commands at a 
specific terminal or reduces’ the number of 
allowable concurrent batch jobs. 


is the terminal to be removed. If the 
terminal is currently in use, the terminal 
user is allowed to continue until a SIGNOFF 
command is’ entered. When the terminal is 
removed, MTM closes the logical unit (lu) 
assignment for the terminal. 


is the number of concurrent batch streams to 
be removed. Currently active jobs are allowed 
to complete execution. If n is greater than 
the number of current batch streams, the 
number of concurrent batch streams supported 
by MT is reduced to zero. If the new number 
of batch streams is less than the number of 
currently active batch jobs, the extra batch 
jobs are allowed to go to completion. 


terminates MTM; new signons are prevented and 
batch job initiation is stopped. When all 
terminal users sign off the system and all 
currently active batch jobs terminate, MTM 
goes to end of task. Before MTM goes to end 
of task, information on the availability and 
usage of and the number of times users had to 
wait for system resources is output. If MT 
discovers that command buffers are missing 
(the buffer chain has been broken), it pauses 
to allow user action (such as a panic dump). 
When the CONTINUE command is entered, MTM goes 
to end of task code 210. 
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PURGE removes a batch job from the system and from 
the batch queue. If the batch job is 
currently active, it is cancelled. 


fd is the file descriptor of the file containing 
the batch job. 


INQUIRE displays the status of a batch job. 


fd is the file descriptor of the file containing 
the batch job. If fd is omitted, the status 
of all submitted jobs is displayed. 


SUBMIT adds a job to the batch queue. 


fd is the file descriptor of the file containing 
the batch job to be added to the batch queue. 


ATF changes the accounting transaction file. The 
current ATF is closed and a new ATF is 
allocated (if necessary) and assigned. 


fa is the file descriptor of the new ATF. 


Functional Details: 


-MTM STATUS,WAIT, .MTM QUIESCE and .MTM STATUS,USED can be used 
to determine if the numbers specified at MTM sysgen for command 
buffers (NCSBFS), console buffers (NCONBFS), sector buffers 
(NSECTS) and logical units (LINKOPT) are optimal. Increasing the 
available resources at MTM sysgen can help to eliminate excessive 
wait conditions. Decreasing resources can eliminate unnecessary 
memory overhead. 


Examples: 


Sample output from the .MTM STATUS command: 


-MTM STA 

-MTM: TERMINAL USERS - 

-MTM: 0583 2—-BATCH>MTM-MODE 0S3220-BATCH>MTM-MODE LEE-CT42: >)MTM-MODE 
-MTM: ROD-CT4C: )MTM-MODE RICH-CT7A: @MTM-MODE LAURIE~-CT7C: @MTM-MODE 
-MTM: JOB M300:0S832.JOB/96 EXECUTING USER ID=0S832 

-MTM: JOB M300:08S3220.J0B/96 EXECUTING USER ID=0S3220 

-MTM:WAITING JOBS = 1 

-MT™M: 2 BATCH STREAMS 
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Sample output from the .MTM STATUS,WAIT command: 


-MTM STA,W 

-MTM: TOTAL PEAK CURRENT WAITS 

.MTM: 42 32 29 O CMD BUFFERS 

.-MTM: 0 0 — QO O CON BUFFERS 

-MTM: 7 4 0 O SEC BUFFEFS 

-MTM: 50 10 6 O LU 

Where: 

TOTAL indicates the maximum number available. 

PEAK indicates the maximum number concurrently 
used. 

CURRENT indicates the number in use at the time the 
command was executed. 

WAITS indicates the number of times users were 


placed in a wait state. 
Sample output from the .MTM STATUS, TERMINAL command: 


-MTM STA,T 

-MTM: TERMINAL USERS - 

-MTM:0S832-BATCH>MTM-MODE 0OS3220-BATCH>MTM-MODE LEE-CT42: >)MTM-MODE 
-MTM: ROD-CT4C : )MTM-MODE RICH-CT7A: @MTM-MODE LAURIE-CT7C: @MTM-MODE 


Sample output from the .MTM STATUS,BATCH command: 


-MTIM STA,B 

-MTM: JOB M300:0S832.J0B/96 EXECUTING USER [D=0S832 
-MTM: JOB M300:0S3220.J0B/96 EXECUTING USER [D=0S3220 
-MTM:WAITING JOBS = L 

-MTM: 2 BATCH STREAMS 


This .MTM STATUS,USED command displays, in histogram format, the 
number of times the indicated number of command buffers were used 
concurrently. Figure 5-1 indicates, for example, that four 
command buffers were concurrently used three times, 12 were 
concurrently used 90 times and 24 were concurrently used 900 
Limes. 


5-8 48-023 FOO RO3 


--> 
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# OF TIMES USED 
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| USED 
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we te we oe we we oe ae oe ow ww ee we ew eer ee er ee KK KM RM MK MK KM om wm 
x xx uk KKK KR KK KM 
x xxx KK KK KK KM KK 
x xx xK KKK KKK KR KK 
x x xxx KK KK KR KK KK 
x * x xx KKK MM KK KK KH 
x x x *K xxx KK KRM KK KK KM 
xx KK KKM HK MK KKM KM KM HM 
xx KX KK KH KM KM KM KKM KK 
xxx xX KKK KKK KM KKM KK 
we ew ee we ee wm ee we mer KKH KM KKM KKM KH HM KM KM M KM MM KM KM ee mw 
xxx x x KK KK KKM KKK KK KR KM MK 
x xu x KKK KKM KKM KM KKK HK MM K 
xx KKK KKK KKM KK KKM KKK KM KH 
xx KKK MK KM KH KR KK KKK MK 
KM KK MK MK MK KK KKM KK KH KKK K KM 
HMR MK KKK M MK KK MH KKK HK MM KK HK 
x KKK KKM KK KRHK KK KM KH KM KK KKK KM HK 
xr MK KKM KM KK MK MMM HMMM KM KK HK 
xx M KH KKK KKM HK MK MM KKK HK HK RK HK KKK 
ANMNAWUWOMADHOANMNAMVIOEANHODOANMNHFWOWOM™ AAO 
AA nM AD AA ADAANNNNNNANNNNN®™ 
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Figure 5-1 Sample Output from the .-MTM STATUS,USED Command 


5-9 


The .MTM TELL and .MTM MESSAGE commands”) send the indicated 
message to the terminal signed on with a userid of SAM. 


-MTM TEL SAM, YOUR MAG TAPE IS MOUNTED. 


-MTM ME SAM, YOUR MAG TAPE IS MOUNTED. 


The .MTM BROADCAST command sends the indicated message to all 
terminals currently assigned to MIM. 


-MTM BRO MTM IS GOING DOWN IN 15 MINUTES. 
This .MTM ADD command adds the device CRT2: to MTM. 
-MTM ADD CRT2: 


This .MTM ADD command increases the number of batch = streams 
allowed by 2. 


-MTM ADD BATCH 2 


This .MTM TERMINATE command terminates the user signed onto 
CRT8:. 


-MTM TER CRT8: 


This .MTM REMOVE command removes CRT10: from MTM upon the next 
sign off command. 


-MTM REM CRT10: 


This .MTM REMOVE command decreases the number of batch streams 
allowed by 3. 


-MTM REM BATCH 3 


The .MTM QUIESCE command terminates MTM after all users’ have 
signed off and all batch jobs have terminated. 
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The following table is output prior to MTM termination. 


-MTM QUIESCE 


-MTM: TOTAL PEAK CURRENT WAITS .MTM: 42 32 29 0 CMD BUFFERS 
.MTM: 0 O 0 0 CON BUFFERS .MTM: 7 4 0 O SEC BUFFERS .MTM: 50 
10 6 O LU .MTM END OF TASK CODE 0O 


The .MTM PURGE command cancels the indicated batch job if active, 
or removes it from the batch queue if not active. 


-MTM PUR MT30:TEST.JOB/8 


The .MTM INQUIRE command displays the status of all submitted 
jobs. 


.MTM INQ 
.MTM:JOB M300:08832.J0B/96 EXECUTING 
.MTM:JOB M300:083220.J0B/96 EXECUTING 
.MTM:JOB M300:0S3230.J0B/96 WAITING 


This .MTM INQUIRE command displays the status of the specified 
Job. 


-MTM INQ FRED: TASK.JOB/18 JOB FRED:TASK.JOB/18 NOT FOUND 


The .MTM SUBMIT command adds the specified job to the batch 
queue. 


-MTM SUB MT30:TEST.JOB/8 
5.5 MULTI-TERMINAL MONITOR (MTM) END OF TASK CODES 
With the exception of end of task codes 0 and 255, MTM goes’ to 


end of task due to ae situation that it cannot resolve. The 
format of the end of task message on the system console is: 


-MTM END OF TASK CODE nnn 


The MTM end of task codes and meanings are listed in Table 5-1. 
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TABLE 5-1 MTM END OF TASK CODES 


CODE |} MEAN ING 
"Q { Indicates normal end of task. stst—=—<CSst=<CS 
1 Indicates no message buffers. 
2 Illegal entry was removed from the task queue. 
3 The task has just been loaded but its task control 


block (TCB) cannot be located. 


| 
1 H 
| 
H 4 } An SVC6 error has occurred, but the error is not 1 
H { listed in the error table. | 
! { i] 
| t ' 
H 6 | .MTM START parameter(s) is wrong. H 
{ 1 ! 
! ’ | 
H 7 {| A command buffer length of less than 72 or NUSERS less |} 
1 i than 1 was specified. H 
{ { t 
' ' ' 
1 8 | The address for the device mnemonic table (DMT) in the |} 
H { volume mnemonic table (VMT) is O for a direct access | 
| volume. 
{ t t 
i] J ’ 
H 9 {| A read or write request was made to record 0 in the 
| batch queue; this request is illegal. 
{ f t 
| i ! 
{; J1 | The number of 1/0 classes in the operating system is 
| larger than those in the MTM sysgen. 
1 § ] 
I I ! 
i; 12 | MTM could not assign the system console. 
' ‘ t 
! I J 
; 200 ; The priority scheduling mechanism (PSM) was specified | 
{} without accounting support. H 
t | t 
t ' l 
; 210  }{ Command buffers are missing upon .MTM QUIESCE (the 
H | buffer chain is broken). H 
1 1 t 
t ! ! 
| 254 {| A user attempted to restart MIM; MTM is not a 
| restartable task. H 
1 l ! 
} | ' 
{ 255 | MTM has been cancelled. 1 
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5.6 MULTI-TERMINAL MONITOR (MTM) ERROR MESSAGES 


The following error messages are generated on MTM. 


BATCH ASGN-ERR TYPE=ASGN JOB=fd/act 
indicates the lu was not assigned when trying to assign 
a file at the start of a batch job. 
BATCH ASGN-ERR TYPE=BUFF JOB=fd/act 
indicates system space was insufficient to obtain a file 
control block (FCB) when trying to assign a file at the 
start of a batch job. 
BATCH ASGN-ERR TYPE=FUNC JOB=fd/act 
indicates an invalid function was’ detected for a 
specified device/file when trying to assign it at the 
start of a batch job. 
BATCH ASGN-ERR TYPE=1/0 JOB=fd/act 
indicates an I/O error was detected on a_ specified file 
when trying to assign the file at the start of a batch 
job. 
BATCH ASGN-ERR TYPE=lu JOB=fd/act 
indicates an illegal or unassigned lu was detected when 
trying to assign a file at the start of a batch job. 
BATCH ASGN-ERR TYPE=NAME JOB=fd/act 
indicates a mismatched filename.ext was detected when 
trying to assign a file at the start of a batch job. 
BATCH ASGN-ERR TYPE=PRIV JOB=fd/act 
indicates a mismatched access privilege was detected when 
trying to assign a file at the start of a batch job. 
BATCH ASGN-ERR TYPE=SIZE JOB=fd/act 


indicates erroneous record length/size was detected when 
trying to assign a file at the start of a batch job. 
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BATCH ASGN-ERR TYPE=VOL JOB=fd/act 


indicates no such volume/device was detected when trying 
to assign a file at the start of a batch job. 


BATCH NOT ACTIVE 


indicates MTM was started without a batch queue, and a 
batch request had been made. 


BATCH QUEUE ASGN-ERR 


indicates the batch queue specified in the START command 
could not be assigned. 


BATCH QUEUE I/O-ERR TYPE=DU- - -ALL BATCH REMOVED- - - 


indicates device unavailable was detected on batch queue. 


BATCH QUEUE I/O-ERR TYPE=EOF- - -ALL BATCH REMOVED- - - 
indicates an end of file (EOF) was detected on batch 
queue. 

BATCH QUEUE I/O-ERR TYPE=EOM- - -ALL BATCH REMOVED- - - 


indicates an end of medium (EOM) error was detected on 
batch queue. 


BATCH QUEUE 1 /O-ERR TYPE=PRTY- - -ALL BATCH REMOVED- - - 


indicates parity or a recoverable error was detected on 
batch queue. 


BATCH QUEUE I/O-ERR TYPE=UNRV- - -ALL BATCH REMOVED- - - 


indicates an irrecoverable error was detected on batch 
queue. 


BATCH QUEUE LRECL-ERR 


indicates a batch queue given in the START command has an 
invalid record length of less than 40 bytes. 


CANNOT ASSIGN AUF FILE 


indicates that MTM cannot assign an AUF. 
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xxxx CMD BUFFERS MISSING 
indicates that the number of command buffers specified by 
xxxx has been discovered to be missing upon .MTM QUIESCE. 

COMMAND BUFFER LENGTH LESS THAN 72 
indicates that a command buffer length of less than 72 
bytes or NUSERS less than 1 was specified. 

dev-I/O ERROR status USER TERMINATED 
indicates an irrecoverable error has occurred on a 
device; the error status returned is indicated as the 
status. MTM automatically signs off a user signed on to 
the device. 

EXTRANEOUS OPERANDS 


indicates an MTM command has too many operands. 


FILE DESCRIPTOR ERROR 
indicates the fd specified in the command is omitted or 
its format is incorrect. 

INVALID COMMAND 


indicates the MTM command entered is unrecognized. 


INVALID PARAMETER 
indicates a command has been entered with an invalid 
parameter or bad syntax or the device cannot be found. 
voln:MTMASST.TSK/S HAS WRONG REVISION LEVEL 
indicates that the revision level for -MTMASST is 
incorrect. Execution of the .MTMASST task is cancelled. 
voln:MTMASST.TSK/S NOT FOUND OR LOAD ERROR 
indicates that the .MTMASST task could not be executed 


because the MTMASST.TSK/S file could not be found, or an 
error occurred when the task was loaded. 
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NO BUFFER AVAIL FOR CMD 


indicates that all command and message buffers are full. 


START OPTIONS FORM-ERR 


indicates an invalid format in the START command. 


START OPTIONS PARM-ERR 


indicates an invalid START parameter. 


TERMINAL ASSIGN ERROR 


indicates an attempt to add a new terminal to the system 
has failed. The device is not recognized or not 


available. 


TERMINALS OR BATCH EXCEED MAXIMUM 
indicates the number of concurrent batch streams allowed 
exceeds 64, the number of terminals exceeds 64, or the 


number of batch streams and terminals exceed the NUSERS 
established at MTM sysgen time. 


USERID NOT FOUND 


indicates a current user has not been found with this 
identification. 
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CHAPTER 6 
MULTI-TERMINAL MONITOR (MTM) OPERATION IN A 
MODEL 3200MPS SYSTEM MULTIPROCESSING ENVIRONMENT 


6.1 INTRODUCTION 


When an MTM operates in a Perkin-Elmer Model 3200MPS System 
multiprocessing environment, an MTM subtask can be executed on 
any processor in the system. The terminal user can manually 
assign a task to a specific processor queue by: 


@ entering an OPTION LPU command after loading the task (see the 
OS/32 Multi-Terminal Monitor (MTM) Reference Manual), or 


e linking the task with the LPU= option (see the OS/32 Link 
Reference Manual). 


Whether or not the above methods enhance system performance 
depends upon the task load of the particular processor assigned 
to the task in relation to the task loads of other processors’. in 
the system. Since a single terminal user may not be familiar 
with the requirements of the entire MTM installation, he may be 
unable to choose the processor that will result in optimum system 
performance. An improper auxiliary processing unit (APU) task 
assignment may even inhibit system performance. 


To overcome the disadvantages of manual APU task queue 
assignment, Perkin-Elmer provides load leveling executive (LLE) 
software. This software supplies the MTM system administrator 
with an automatic method of APU task queue assignment that is 
designed to take full advantage of the multiprocessing 
capabilities of the Model 3200MPS System. LLE automatically 
directs MTM subtasks either to the central processing unit (CPU) 
ready queue or to APU queue O depending on the run-time behavior 
of these subtasks. The subtasks scheduling priority is 
calculated by the priority scheduling mechanism (PSM) embedded in 
MTM. 


Once activated, LLE forces all subtasks without the supervisor 
call 6 (SVC6) control privilege (see Section 3.4.9) to use 
logical processing unit (LPU) O and operates only on these 
subtasks. All LLE operations on the subtasks are transparent to 
the terminal user. 
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LLE also collects system related information and prepares 
statistics displayed with the .MTM LLE DISPLAY command. 


This chapter describes the operation of the LLE software and the 
system administrator's responsibilities for initializing, 
controlling and optimizing LLE for optimum system performance. 


6.2 OPERATION OF THE LOAD LEVELING EXECUTIVE (LLE) 


MTM subtasks running in a Model 3200MPS System can be made 
subject to execution on the CPU or an APU. Tasks that are 
subject to execution on the CPU are organized into a special task 
scheduling queue called the CPU ready queue. Tasks subject to 
execution on an APU are organized in one of the APU queues. For 
load leveling purposes, a CPU/APU shared queue called queue 0 is 
used. Queue O is serviced by all APUs assigned to queue O and 
the CPU; the CPU ,however, will only service this queue when its 
own ready queue is empty. 


The task requests for operating system services (SVCs, fault and 
trap processing) are fulfilled on the CPU ready queue. Whenever 
a service is required by a task assigned to queue 0, the task is 
transferred (passed back) to the CPU ready queue. Upon service 
completion, the task is passed back to queue 0 by the operating 
system. The LLE minimizes the traffic between the two queues 
(APU/CPU thrashing) according to the tasks' run-time behavior. 
Essentially, the computation-intensive tasks are directed to LPU 
O, which is always mapped to APU queue 0. Tasks can now be 
executed by any processor in the system (thus achieving load 
leveling). The service-intensive tasks (e.g., I/O-intensive) are 
directed to the CPU ready queue. 


LLE executes as a subtask of MTM and has a taskid of .MTMLLE. 

MTM loads, starts and controls the LLE task via commands entered 
at the system console. The task priority of .MTMLLE is 10. Once 
LLE is started, it runs periodically at a PSM interval controlled 
by the system operator. 


6.2.1 Queue 0 Eligibility 
LLE employs a queue 0 eligibility algorithm to determine which 


MIM subtasks are to be directed to queue 0. Queue O eligibility 
of a task, E, is computed as follows: 


E = 100%*(P-NP*TP) /PM 
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Where: 


P is the task processor time (CPU and APU user 
time) during the last PSM interval. 


NP is the number of task transfers (passbacks) 
from APU to CPU during the last interval. 


TP is passback overhead time (i.e., an estimate 
of time spent by 0OS/32 to handle passback). 


PM is the maximum task processor time allowed in 
a PSM interval. 


If the above equation for E yields a negative value, E is set to 
0. For active tasks that did not obtain any processor time in 
the last PSM interval, the value of E calculated at the previous 
PSM interval is used. 


Hence, a task that consumed all of the processor time allowed in 
a PSM interval and had no passbacks during the last PSM interval 
is 100% queue O eligible for the next PSM interval. During a PSM 
interval, a task that uses 100ms of CPU and APU time and makes 15 
passbacks with an estimated lms of overhead each, will be 85% 
queue O eligible. 


0S/32, the APUs and PSM supply the run-time behavior information 
needed by LLE to determine queue O eligibility. The resultant 
queue 0 eligibility for the task is compared against a fixed 
eligibility level established by the system operator when LLE is 
started. If the task's queue 0 eligibility is greater than the 
fixed level, the task is directed to queve 0. If it is equal to 
or less than the fixed level, the task is directed to the CPU 
ready queue. 


6.2.2 Prevention of Central Processing Unit (CPU) Overload 


The queue 0 eligibility algorithm checks whether the CPU was 
overloaded, (i.e., did not service queue 0 during the last PSM 
interval). This is accomplished by using the CPU queue 0 access 
count, which is incremented by the operating system. If the CPU 
was overloaded, one task with queue eligibility less than the 
fixed level is directed to queue O for the next interval. 
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6.2.3 Error Termination 


During execution, the LLE task continually checks queue 0 to 
ensure that at least one APU is assigned to the queue. If no APU 
is assigned to queue 0, LLE goes to end of task after sending the 
following message to the system console: 


NO APU ASSIGNED TO QUEUE-LLE TERMINATES 


If execution of the LLE task terminates or is suspended because 
of an error, MTM immediately discontinues communication with the 
task and informs the operator of LLE error status by sending a 
message to the system console. MTM then redirects all subtasks 
on queue 0 to the CPU ready queue. Until LLE is reactivated via 
an LLE control command, all MTM subtasks are started from the CPU 
ready queue. This process’ is entirely transparent to the MIM 
terminal user. 


6.3 OPTIMIZATION AND CONTROL OF LOAD-LEVELING 
The system operator is able to optimize load-leveling for a 
particular installation by controlling the following values: 


e PSM interval length 


@ Maximum number of I/O operations allowed for a task during the 
PSM interval 


e Maximum processor time allowed for a task during the PSM 
interval 


e Queue 0 eligibility limit 


These values are displayed and changed using the .MTM PSM and 
-MTM LLE commands (see Section 6.4). The decisions to change the 
above values are based on: 


e Establishing criteria for load-leveling at the given 
installation; e.g., maximum system throughput with a limit on 
user response time, maximum speed of response with a limit on 
how low the system throughput can fall or minimum system 
overhead, etc. 
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@ Sampling applicable accounting data to determine a favorable 
change of parameters upon varying the above values; e.g., 
increasing PSM interval length generally reduces overhead, but 
increases the response delay; increasing the next two values 
increases throughput for the I[/0- or computation-intensive 
tasks, respectively, but will decrease response time; increase 
of the eligibility limit lowers the passback overhead, but 
also decreases APU utilization, etc. 


The system operator is able to monitor and control LLE execution 
and initial task direction to the appropriate queue. This way 
the traffic optimization between the queues provided by the LLE 
is enabled or disabled and the initial task distribution is set. 
These functions are performed using the .MTM LLE command. 

6.4 LOAD-LEVELING OPTIMIZING AND CONTROL (.MTM LLE) COMMANDS 

The commands used by the system administrator to optimize and 
control operation of the LLE are: 

e .MTM LLE CPU 

e .MTM LLE DISPLAY 

e .MTM LLE ELIGIBLE 

e .MTM LLE LPU 

@ .MTIM LLE OFF 


e .MTM LLE ON 

The commands used by the system administrator to control the PSM 
@ .MTM PSM 

e@e .MTM PSM INTERVAL 


e@ .MTM PSM [I/O 


@ .MTM PSM MAXPROCESSOR 
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6.4. 


1 .MTM LLE Command 


The .MTM LLE command enables the system operator to control the 


LLE. 


Format: 


-MTM LLE 


Parameters: 


LPU 


CPU 


DISPLAY 


OFF 


ON 


LPU 
CPU 


DISPLAY 


OFF 
ON 


n,F 
ELIGIBILITY| < (os 
»N 


When LLE is active, this command will cause 
MTM to place all of its subtasks (which are 
able to run on an APU) on queue O (LPU O 
directed). When LLE is not active, this 
command will be rejected and the MTM- subtasks 
will be placed on the CPU ready queue. 


When LLE is active, this command will cause 
MIM to place all of its subtasks on the CPU 
ready queue. 


This command displays current variable/fixed 
threshold values, PSM values, CPU and APU 
loads and queue information to the _ system 
console. 


This command removes the LLE from the’ system; 
all future starts of MTM subtasks will be on 
the CPU ready queue. 


This command will load and start the LLE 


(taskid = .MTMLLE). Eligibility is set to its 
default which is 1%. 
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ELIGIBILITY This command controls the eligibility value 
and/or the evaluation logic. 


n is the fixed queue 0 eligibility value in 
percent. The range of n is between 1 and 
99. 

F is the fixed queue 0 eligibility mode for 
the LLE. 

D is the dynamic queue 0 eligibility mode 


for the LLE. 


N is the nooperation mode for the LLE. 


Functional Details: 


The .MTM LLE commands require that MTM is sysgened with the PSM 
(see Section 2.4.21). 


WARNING 


THE LLE DOES NOT CONTROL ALL OF THE TASKS 
CAPABLE TO EXECUTE ON APU QUEUE 0. 
NAMELY, IT DOES NOT CONTROL MTM SUBTASKS 
WITH THE SVC6 COMMUNICATIONS PRIVILEGE 
LOADED FROM THE OPERATOR CONSOLE. THIS 
MAY LEAD TO MONOPOLIZATION OF APUs 
ASS IGNED TO QUEUE 0 BY SUCH 
UNCONTROLLABLE TASKS AND THEREBY DEGRADES 
PERFORMANCE OF MTM SUBTASKS. 


After the .MTM LLE OFF command is entered, MTM subtasks which are 
on queue 0 are transferred back to the CPU ready queue. 


After the .MTM LLE ON command is entered, MTM checks that the PSM 
was enabled at MTM sysgen. If the PSM was not’ enabled, this 
command is rejected. If the PSM was enabled, MTM issues an SVC13 
to set queue 0 to enforced priority order and loads the LLE. MTM 
then checks the LLE revision level to ensure that the proper 
terminal user (TUB) structure is used. An error message is then 
output to the system console to inform the user that LLE has been 
cancelled. 


The .MTM LLE ELIGIBILITY command, when set to the fixed mode, 
enables the system operator to establish a fixed queue 0 
eligibility level. The range of n is between 1 and 99, which 
indicates the fixed queue 0 eligibility value. This value sets 
the fixed queue O eligibility value for the LLE and is used to 
determine if a task is to be placed on either queue O or the CPU 
ready queue. . 
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When the .MTM LLE ELIGIBILITY command is set to the dynamic mode, 
LLE switches to a CPU-overload algorithm to determine queue 0 
eligibility in cases of CPU overload. In cases where the CPU is 
under loaded or up to 100% loaded, no dynamic threshold value 
change is necessary. The LLE maintains enough queue 0 
eligibility tasks on queue O to keep APUs and the CPU busy. 


CPU overload is a critical case for the LLE. The LLE is informed 
of a CPU overload condition when the counter for CPU access. to 
queue O is zero for the last PSM interval. The LLE reacts with 
a change of the variable threshold for queue 0 eligible tasks’ to 
force more tasks less queue 0 eligibility to be moved to queue 0. 
The formula is as follows: 


CPU unload = [(CPU+APU time) -passbacks]*overhead 
Where: 
CPU+tAPU time is the total processor time used by the 


subtask during the last PSM interval. 


passbacks is the number of passbacks that occurred in 
the last PSM interval for the subtask. 


overhead is the CPU overhead time required to complete 
one passback for the subtask. 


If the CPU unload value for the task is greater than zero, the 
CPU will be unloaded by this value if the task executes on an 
APU. The LLE never moves a task with a negative or zero value to 
queue O because this would cause the CPU to be even more 
over loaded. 


When the .MTM LLE ELIGIBILITY command is set to the nooperation 
mode, the LLE will not cancel the task but will store the task in 
memory for future use. Otherwise the eligibility n value is lost 
and set to its default when LLE is turned back on. 


Examples: 


This example causes MTM subtasks under LLE control to be _ placed 
on queue 0: 


-MTM LLE LPO 
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The .MTM LLE DISPLAY command outputs the following information to 
the system console: 


14: 
14: 
14: 
14: 
14: 
14: 
14: 
14: 
14: 
14: 
14: 
14: 
14: 
14: 
14: 
14: 
14: 
14: 


56: 
245 
245 
245 
245 
245 
245 
56: 
56: 
56: 
245 
245 
245 
245 
2:45 
245 
245 
245 


56 
56 
56 
56 
56 
56 


56 
56 
56 
56 
56 
56 
56 
56 


45 


45 
45 
45 


Or 
or 


:PSM: INTERVAL= 4 1/O= 335 


:LLE MODE=DYNAMIC 
:LLE MODE=FIXED 
:LLE MODE=NOOPERATION 


MAXPROCESSOR=25 $% 


ELIGIBLE= 1.0 % 
ELIGIBLE= 0.0 % 


: LOAD: LAST 4 SEC LAST 40 SEC SINCE START 
3 CPU 18.8 % 4.5 % 6.8 % 
APU1L 0.0 % 0.0 % 0.0 % 


:MTM: SUBTASK INFORMATION 


LPU O DIRECTED 0 
CPU DIRECTED 4 
CPU READY QUEUE 0 
CPU REC. QUEUE 0 
QUEUE 0 4 
EXEC/WAIT/ROLLED 0 


This example removes LLE from the system: 


-MTM LLE OFF 


The following example loads the 


system volume: 


-MTM LILLE ON 


TASKS 
TASKS 
TASKS 
TASKS 
TASKS 
TASKS 


MTMLLE.TSK/S from the default 


Table 6-1 lists the error messages output by these commands. 
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TABLE 6-1 LLE ERROR MESSAGES 


i A Nc tN aN Ne ite ieee nett tenn het antnteen! 


ERROR MESSAGE 


ERROR: NO PSM OR 
NON MPS 3200 SYSTEM 


WARNING: LILLE 
STATUS=OFF 


The command was entered when the 
LLE task was in an undefined state. 
The command will have no effect on 
task direction to queues until the 
LLE task is activated. 


WARNING: LLE 
STATUS=UNDEF INED 


ae me cee mem ee ee eee eee ce ee ce ee ae ae ee ee re ee ee nem ne ee ee ee ee ee ea en ee ee ee ee ee es ee oe 


The command was entered when the 
LLE task was in a paused state. 

The command will have no effect on 
task direction to queues until the 
LLE task is reactivated. 


WARNING: LLE 
STATUS=PAUSED 


ee ere re rm tee ee ee ee ene ee ee eee ce are ee me re me oe ae ae ee ee eee ee ee ee ee ee ee ee ee oe ee ee a ee 


The command was entered when the 
LLE task was in a time-out state 
due to overflow of 
event queue. The command will have 
no effect on task direction to 
queues until the LLE task is 
reactived. 


WARNING: LLE 
STATUS=T IMEOUT 
(TASK QUEUE 
OVERFLOW) 


The command was entered when the 
LLE task was in a suspended state 
due to a memory fault. The 
command will have no effect on 
task direction to queues until the 
LLE task is reactivated. 


WARNING: LLE 
STATUS =MEMORY 
FAULT (instruction 
address/memory 


address) 


AFFECTED COMMANDS 
Sees 22522 2 ee oe ee oe et oe 8 oe oe 5m ee die oe a mt Se 2 ot an eh nn i tk a a fe Se At ee a 2 ee BO Oe 22 ee ae ee oe bee ee oe ot 
The entered command is rejected 
because PSM was not sysgeried or 

the command was entered on a 
system other than a Model 3200MPS. 


cae ee ee ee ee ee ee ee ee ee 


BEEBRR I 


CPU 
DISPLAY 
ELIGIBLE 
LPU 


CPU 
ELIGIBLE 
LPU 


DISPLAY 
OFF 


CPU 
ELIGIBLE 
LPU 


DISPLAY 
OFF 


CPU 
ELIGIBLE 
LPU 


DISPLAY 
OFF 


CPU 
ELIGIBLE 
LPU 


DISPLAY 
OFF 


CPU 
ELIGIBLE 
LPU 


DISPLAY 
OFF 
ON 


ne 


The command was entered when the 
LLE task was in an inactive state. 
The command will have no effect on 
task direction to queues until the 
LLE task is activated. 


The command is rejected because 
the LLE task is in the inactive 


state. 


The command is rejected because 
the LLE task is in an undefined 


state. 


The command is rejected because 
the LLE task is in the paused 


state. 


The command is rejected because 
the LLE task is in the time-out 


state. 


The command is rejected because 
the LLE task is in 
state due to a memory fault. 


MEAN I NG 


ee ee ee we ee ee ee ee ee ee we ee we me ee ee ee we oe 


.MTM LLE task 


a suspended 


eee ee ee ee ee ee ee ee ee oe 
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TABLE 6-1 LLE ERROR MESSAGES (Continued) 


ERROR MESSAGE \ AFFECTED COMMANDS { MEAN ING 
WARNING: LLE ' .MTM LLE CPU { The command was entered when the 


STATUS=ILLEGAL 
INSTRUCTION 
(address) 


-MTM LLE ELIGIBLE 
-MTM LLE LPU 


1 
; LLE task was in a suspended state 
} Que to an illegal instruction 

{| fault. The command will have no 

ij effect on task direction to queues 
' until the LLE task is reactivated. 
i] 

: 

i] 

' 

| 

i 


-MTM LLE DISPLAY 
-MTM LLE OFF 
-MTM LLE ON 


The command is rejected because 

the LLE task is in a suspended 
state due to an illegal instruc- 
tion fault. 

| pSSe eee Seto lie eee ee eee eee eee eee oleae eee ee eee cee eee eee 


ERROR: FILE The command is rejected because 


] 
( 
' 
t 
’ 
' 
4 
' 
1 
{ 
a 
i 
i 
' 
' 
' 
' 
' 
' 
' 
4 
t 
! 
t 
' 
' 
' 


i DESCRIPTOR { | -MTM cannot load the LLE task due 
| ERROR { } to an fd error. 
\ me cm eee ee eee am ee ee em em me ee om ae cee me ae eee cas ae ee aes a aes fas et os ewe ee ot ee ew eo 
| ERROR: LLE i .MTM LLE ON ;} The command is ignored because an 
| STATUS=ON H | attempt was made to start the LLE 
H i i task when the task is already 
i H | active. 
ERROR: LLE -MTM LLE CPU The command cannot be performed; 


STATUS+yyyy AT the LLE may be in one of the 


H 

{ { H 

| erradd/LLE.SAD | .MTM LLE ELIGIBILITY | following error states where yyyy 

| AT segadd | -MTM LLE LPU i is replaced by: 

H } .MTM LLE OFF | | 

| } .MTM LLE ON | 222? = undefined (paused, 

i H H looping, etc.) 

H H i NAPU = no APUs assigned to queue 

H { H 8) 

i i | ILGF = internal logic fault 

H { | ARFT = arithmetic fault 

i H | PWFT = power fail trap 

i H | DFFT = data format fault 

i i | TINS = illegal instruction 

H H | MMAL = machine malfunction 

{ H | errad = the absolute address 

{ | H where the error occurred. 

H H } segadd@ = the absolute address 

H } | where .MTM LL UDL 

H ' | starts. To recover from 

{ H H those errors, use the .MTM 

H i { LLE OFF command, then the 

{ ' { .MTM LLE ON command. 

| ce ic es ae a ee ee a ese eee a ev a ns a a aa Sea es la cata ss md inward eee ee, Te 

i ERROR: LOAD OR | .MTM LLE ON {| Indicates that the load of the LLE 

} START ERROR, | | returned an error status for the 

| SVC6, STATUS= { | SVC6. yyyy is the hex status 

i X'yyyy' H | returned by the SVC6 handler. 

| ewe ee en nnn ee nn nn nn nn 8 nn en nn nnn ene 

| ERROR: voln: {| .MTM LLE ON { Indicates that the MTMLLE.TSK/S on 

| MTMLLE.TSK/S H i the default system volume (voln: ) 

| ASSIGN ERROR | } could not be assigned to .MTM. 

Vn ee en a nn nn nn nn nn nn nn nn nnn 
ERROR: voln: MTM LLE ON Indicates that the MTMLLE.TSK.S on 


HAS WRONG has a different revision than the 
REVISION LEVEL -MTM task currently executing. 


i i 

MTMLLE .TSK/S H | the default system volume (voln: ) 
! 1 
! ! 
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6.4. 


2 .MTM PSM Command 


This command enables the system operator to control the PSM. 


Format: 


-MTM PSM< 1/0 no 


MAXPROCESSOR nz 


Parameters: 


PSM 


INTERVAL 


ny 


1/0 


No 


MAXPROCESSOR 


N3 


indicates that this command is directed to the 
PSM handler within .MTM. If no further 
parameter is specified, the current PSM values 
are displayed on the system console. 


selects the interval value for change. 


is the time interval in seconds between the 
PSM priority recomputing cycles. The range 
for n is 1 through 10. 


selects the I/O count for change. 


sets the maximum number of I/O (performed in 
the last PSM interval) that are used to 
recompute the new priority for an MTM subtask. 
The range for n is 1 through 9,999. 


selects the MAXPROCESSOR value for change. 


is used as a percent value in PSM to determine 
the MTM subtask priority. If an MTM subtask 
uses more than this value of processor time 
(in the last PSM interval), it's priority is 
reset to the lowest PSM priority. 
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Functional Details: 

The new PSM values are displayed after each command to the system 
console. The defaults set up at the start of MTM are as follows: 
Interval n = 4 sec / [/O n = 500 / MAXPROCESSOR n = 25 % 

Example: 


This example selects an I/O count of 335 and the _ following 
information is returned: 


-MTM PSM [/0 335 
10:02:20 -MTM: CURRENT PSM: INTERVAL=04 SEC I /0=0335 MAXPROCESSOR=25 % 


Table 6-2 lists the error messages output by these commands. 


TABLE 6-2 PSM ERROR MESSAGES 


eens ete Na a A PR HORE Kea NE KD NS UNM EN RS Tey GS Say MOND emeh Ate emma We mes cute ceeme UES ks RS en me ee ee RU nome ne re LU Ke nn Re A Fe OR ee TU an La ey UR Re eee ene NU Le ee 


| ERROR MESSAGE | AFFECTED COMMANDS H MEAN ING H 
H FSS KM SVS SK SCI TSTMK MK SSF SPSS SFSEASE SSL STASIS VSVSsSss SSS SSE SS STS S TSS SVS STK SS sss SSS H 
| INVALID | .MTM PSM INTERVAL | The given parameter n |} 
| PARAMETER ; »~MTM PSM I/O } is invalid. Check H 
H | ~-MTM PSM MAXPROCESSOR | the value specified H 
H i { and correct accord- { 
| ingly. 
H i l,i’ ar i mia, tha el an Smt “i im ei ii ti eho bts Sasa al 'aisaskenp’ ne ‘Sag” mi Sea maw Sa san “aes. wea Sau‘ wn: l,l etn nd os Ln face vag eame ee { 
| PSM NOT | .MTM PSM | The entered eontand | 
| SYSGENED | .»~MTM PSM INTERVAI } is rejected because 
i } .MTM PSM I[/0 i the PSM was not sys- | 
H i -MTM PSM MAXPROCESSOR ; tem generated (sys- H 
i gened). 
H a oa cS sme ans SS is masse sc chy ASR yrs sae SU senna em Sn el ‘a in a ii al i Gs “cae inCreate Ss i eo { 
i MISSING ' .MTM PSM INTERVAL i The entered command 1 
| OPERAND | .MTM PSM [/0 i has a missing oper- { 
H ' .MTM PSM MAXPROCESSOR |} and. Reenter the ' 
{ } ; command specifying a | 
H ; | value for n. H 
ME as espe snk“ igen “ila lac sy taok lds dh ip, is: Sa, ce Cap sek“ Sabo <email alin cal “a * ns “md it ss ra ig, “Daeg, Seek ap: saa <u “ain sae “aes. ag tac | 
EXTRANEOUS -MTM PSM The entered command 
OPERAND -MTM PSM INTERVAL has an extraneous 


-MTM PSM MAXPROCESSOR command omitting the 
extraneous operand. 


rhe ee einen 


| | | 
| -MTM PSM I[/0 | Operand. Reenter the j} 
' | i 
! ! ! 


48-023 FOO RO3 6-13 


6.5 LOAD-LEVELING EXECUTIVE (LLE) OPERATING TIPS 


Before turning LLE on, the operator should ensure that PSM has 
been sysgened into the system. See Chapter 2 for information on 
the MTM sysgen_ option. LLE overrides LPU task assignment 
supplied via MTM or Link; therefore, the operator should 
broadcast a message to all MTM users that automatic load leveling 
is in effect. The user must have APU and SVC6 control privileges 
to be able to access LPU numbers other than 0. If the MTM 
terminal user wishes to run a task on an APU that is not assigned 
to queue 0, that task can be run from the system console. 
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APPENDIX A 
MULTI-TERMINAL MONITOR (MTM) 
SYSTEM GENERATION (SYSGEN) OPTIONS 


OPTIONS: 
CDBUFSIZ EQU n 
CONBFSZ EQU n 
CSBFSZ EQU n 
NCONBFS EQU n 
NCSBFS EQU n 


NCSSLVS EQU n 


NMSGS EQU n 
NSECTS EQU n 
NUSERS EQU n 
PRCLIMIT EQU n 
QUESIZE EQU n 


SGN.ACT EQU n 


0 
SGN .BTCP ra0) 
i 
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Size of sector buffers 


Size of console buffers 


Size of command buffers 


Number of console buffers 


Number of extra command buffers 


Number of command substitution 
system (CSS) levels 


Number of message buffers 


Number of sector buffers 


Number of concurrent users 


- Processor time Limit 


Size of task queue 


Accounting support/number of classes 


Batch job pause 


SGN.MVOL EQU C'name' Default user volume 


SGN.PRIO EQU n Batch priority 
SGN.SCHR EQU n Subtask scheduling 
0 
SGN. ROLL B00} f Tasks rollable 
SGN.SPL EQU n SPL/32 support/number of buffers 
SGN.VAR EQU n Numbers of variables. 
SGN.@GLO EQU n Number of new global variables 
SGN.@INT EQU n Number of internal variables 
0 
SGN. $HSP zoo}. | HASP interface 
MACROS : 


IOTAB - I/O class number, identification, limit: 


[label] IOTAB (classno,classid [, iocount]), 


(classno,classid [ iocount ]), 
PRMTDEV - device to which prompt sequence applies: 


label} PRMTDEV a pace 
La ae jase ool oa Liss el asaya 


[label] PRMTDEV (SIGMA,dev, [...,devn]) 
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PRMTSEQ - prompt sequence; command, task, build: 
[label] PRMTSEQ (SIGMA) 


[label] PRMTSEQ (pname,, (com-req,x), (task-exec,x), 
(task-read,x), (build-read,x) ), 


(pname ,(com-req,x), (task-exec,x), 
(task-read,x), (build-read,x) )y] 


[label] PRMTSEQ (STANDARD, (com-req,x), (task-exec,x), 
(task-read,x), (build-read,x), 


UIOLIM - I/O limits, all I/O classes per user class: 


[label] UIOLIM (upiogt,.--,Ugid”t) , (Ugiogb, .. .,Ugiond) 


(uniont,...,uniont), (uniogb,...,Upnionbd) 
UPRCLIM ~ processor time limits for I/O classes: 
[label] UPRCLIM limitot,limitob,...,...,limit,t,limityb 
VERSION - MTM parameter file identification: 


[label] VERSION '‘id' 
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APPENDIX C 
AUTHORIZED USER UTILITY MESSAGE SUMMARY 


taskid > for CON: 
or 
---> under MTM 


is the prompt, generated for an interactive device, 
indicating an input request. 


ACTUTILITY rr-uu 


identifies the Account Utility. The revision level is rr; 
the update level is uu. This message is output only at the’ 
initial start of the Account Utility. 


ACCOUNT UTILITY RUN xx/xx/xx yy:yy:yy 


appears on the system console when the Account Utility is 
started. It informs the operator that the Account Utility 
has been run. 


**XXSET DATE & TIME 


is the date request that pauses the Account Utility so the 
current date and time can be set for the system. The system 
CONTINUE command transfers control back to the Account 
Utility. This message is output when the date and time are 
not set. 


** xX ACCOUNT NUMBER xxx WAS INACTIVE 
indicates the requested command could not be _ performed 


because the indicated account record was inactive. The 
indicated account number is Xxx. 
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***XACCOUNT NUMBER xxx WAS ACTIVE 
indicates the requested command could not be _ performed 
because the indicated account record was already active. The 
indicated account number is xxx. 


ACCOUNTS=n 


indicates the maximum account number on the current AUF. 
*xk*k¥xXxxxxx IS THE CURRENT MODE 


indicates the output from the MODE command. The name of the 
current mode (CREATE, UPDATE or REPORT) 18S XXxXxXxx. 


is the question mark, along with some of the _ following 


messages, used to denote which parameter in the command 
caused the error. The command and ae pointer (?) to the 
location of the error is displayed to the command input 
device. 


**x*xTLLEGAL INPUT COMMAND 


indicates the command word or abbreviation could not be found 
in the table of legal commands. 


***WRONG MODE FOR INPUT COMMAND 


indicates the current mode does not allow the input command. 


*** TLLEGAL COMMAND FORM 


indicates the input command uses too many separators or a 
separator other than a comma or equal character. 


***TLLEGAL PARAMETER 


indicates the input command is missing a required parameter 
or has too many parameters. 


***TLLEGAL START PARAMETER 


indicates a START command word or abbreviation was not found 
in the START command table. 
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APPENDIX C 
AUTHORIZED USER UTILITY MESSAGE SUMMARY 


taskid > for CON: 
or 
--~> under MTM 


is the prompt, generated for an interactive device, 
indicating an input request. 


ACTUTILITY rr-uu 


identifies the Account Utility. The revision level is rr; 
the update level is uu. This message is output only at the 
initial start of the Account Utility. 


ACCOUNT UTILITY RUN xx/xx/xx yy:yy:yy 


appears on the system console wnen the Account Utility is 
started. It informs the operator that the Account Utility 
has been run. 


***SET DATE & TIME 


is the date request that pauses the Account Utility so the 
current date and time can be set for the system. The system 
CONTINUE command transfers control back to the Account 
Utility. This message is output when the date and time are 
not set. 


***X ACCOUNT NUMBER xxx WAS INACTIVE 
indicates the requested command could not be _ performed 


because the indicated account record was inactive. The 
indicated account number is xxx. 
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**xXACCOUNT NUMBER xxx WAS ACTIVE 
indicates the requested command could not be performed 
because the indicated account record was already active. The 
indicated account number is xxx. 


ACCOUNTS =n 


indicates the maximum account number on the current AUF. 


***¥xxxxx IS THE CURRENT MODE 


indicates the output from the MODE command. The name of the 
current mode (CREATE, UPDATE or REPORT) 18 XXXXxXx. 


is the question mark, along with some of the following 
messages, used to denote which parameter in the command 


caused the error. The command and ae pointer (?) to the 
location of the error is displayed to the command input 
device. 


*x*TLELEGAL INPUT COMMAND 
indicates the command word or abbreviation could not be found 
in the table of legal commands. 

***WRONG MODE FOR INPUT COMMAND 


indicates the current mode does not allow the input command. 


** xT LLEGAL COMMAND FORM 


indicates the input command uses too many separators or a 
separator other than a comma or equal character. 


**xTLLEGAL PARAMETER 


indicates the input command is missing a required parameter 
or has too many parameters. 


***TLLEGAL START PARAMETER 


indicates a START command word or abbreviation was not found 
in the START command table. 
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*x*XDUPLICATE START PARAMETER 


indicates the START command contains a duplicate command word 
or more than one mode request. 


*** ILLEGAL FILE DESCRIPTOR 


indicates the file descriptor (fd) used is syntactically 
incorrect. 


***MISSING START PARAMETER 


indicates at least one START parameter is missing from the 
specified mode. 


** XALLOCATION/ASSIGNMENT ERROR 


indicates a file cannot be allocated because of a filename 
conflict or the filename specified for the assignment could 
not be found on the specified disk. 


*x**]u xx NOT ASSIGNED 


indicates a requested function could not be performed because 
the logical unit (lu) xx was not assigned. The utility is 
paused and control transfers to the system. The system 
CONTINUE command continues the utility after the assignment. 


***x INPUT DEVICE ERROR xx on LOGICAL UNIT yy 


indicates an input request has an input/output (1/0) error on 
device xx assigned to lu yy. The Authorized User Utility 
pauses. The system CONTINUE command transfers control back 
to the utility. 


xxxOQUTPUT DEVICE ERROR xx ON LOGICAL UNIT YY 


indicates an output request has the I/O error on device xx 
assigned to lu yy. The Authorized User Utility pauses. The 
system CONTINUE command transfers control back to the 
utility. 


***MISSING PARAMETER 
indicates the input command is missing a required parameter. 
On input errors, where the form of the command or its 


characters are incorrect, the command and a pointer (?) to 
the location of the error is displayed to the user console. 
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**X*MODE NOT ALLOWED 


indicates an attempt to perform an UPDATE or a REPORT was 
made from an account other than 255. 


**xxXWARNING ACCOUNT 255 DOES NOT EXIST 


indicates an attempt to end the Account Utility when = account 
255 does not exist. 
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APPENDIX D 
ACCOUNTING TRANSACTION FILE (ATF) RECORD FORMATS 


The data structure of the ATF is defined by the $ATF data 
structure macro contained in SYSSTRUC.MLB. The fields and 
functional values in the ATF account’ records’ have standard 
symbolic names. These names may be accessed by coding and 
expanding the $ATF data structure macro (see the Common Assembly 
Language Macro/32 Processor (CAL Macro/32) and Macro Library 
Utility Reference Manual). Each of the six ATF account record 
types is associated with a particular type of account activity. 
The record length of an ATF record varies with the number of 
input/output (1/0) classes supported by the system. The record 
formats shown in this appendix are 128 bytes and accept entries 
for the four default I/O classes. The record types are listed in 
Table D-l. 


TABLE D-1 ATF RECORD 


TYPES 
| TYPE | RECORD ACTIVITY | 
| 2 | Signoff | 
Ug ali a ester as ape etn eco eee 
| 3 | Task completion | 
| 4 | Task data overflow | 
| 8 | File deletion | 
fae oe ee se el ae oes a 
! 6 ! File renaming ! 


These six record formats are illustrated in the following 
figures. 


48-023 FOO RO3 . D-1 


NO 


Account Number { 
(ATF .ACCT) H 
i) 
( 


1 16(10) 


120(14) 
{24(18) 
1 28(1C) 


1}32(20) 


136 (24) 


140(28) 


144(2C) 


148(30) 


1 120(78) 


1124(7C) 


Record Type 
(ATF . TYPE) 


Current date and time 
(ATF .CRTM) 


ee ce ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee oe ee eee eee eee eee ee ee ee re ee oe ee ee oe 


User identification 
(ATF .UID) 


Job serial number 


(ATF . JOB) 


ee et ee ee Re eS Se SES MO Me Gee eee a Gee Mee Mm Ge ele ee ee Ge Gi Ae Meee Gt ee ee ES ee eS OY ERE GU Oe ES oe ee en oe ee oe ee 


File descriptor (fd) of 
command input file 


(ATF .UFD) 


to batch queue 


Date and time job was submitted 


(ATF .SUBT 


=! ae ee ne mm cee 


Figure D-1l ATF Format for Signon Account Record Type 


48-023 FOO RO3 


;0(0) Record type }2(2) Account Number : 
i (ATF .TYPE) H ORLES AGeT): 1 
' se a Sasa esc mse, Se i's“ pik. m,n i Se re imine’ “ca sin ed ise 50S as Sei Sk ma sai Sa Gs Pha as dH sh ae, \ 
14(4) Current date and Pine 4 
} (ATF. cee) \ 
H ik ‘amp sh TS cde pe Seles ti dul wil, inn Sm “en ‘a. ta ac nes “pn et a se, eal nde i ar “esleDn “igen Sd cas i, Sansa us” Sis jl app ai. ir a -aan” cas-WSoe aa Pame gs ' 
18(8) 
(oes User identification coor aces 
'12(C) (ATF. Sie 
a a a EN i at aN NN re a a a al wa nats se ata tg cia Sea a ace a ua bp ls ES aes ee cal, at ne nc Ste” dein See ln ' 
I ! 
+} 16(10) Job erat number H 
H (ATF . JOB) | 
‘ a ol i isan’ i SiGe mt mn mn an ra “ea at’ scl ae ea a (mn i * i Sc ei “ans conan a a ec Sa sh Sea a aA Sag ee ' 
1}20(14) Number of tasks }22(16) Number of CSS éania { 
{ run (ATF .TASK) H (ATF. ee2) : 
as cence a ent iy mim fhe om na “ew, mn (i Tapert eb) ncaa Sal Yaa rc Yea sca st esac“ il “ah Sn’ ay ma Pm il H 
1}24(18) Number of commands ;|26(1A) Number of dispray i 
H entered UTES CMDS) ; files (ATF .DISF) H 
H lis ia a hd ata a eas eS a Sas eet tne ce “ts a i es eal Ee ae a ae tela Re os nee we a a ca re ae eae ee et : 
{28(1C) Elapsed time (ATF .EI.PS ) ' 
(oe ee ee ae eee a ee See ee ee ae ea eae nee 
msec) 
eon Filler ae | 
{36(24) 
Be Ss TAS inc nna ‘snd ne ses” sm em nl ula aa cee we, Soy ead Ss "San Sms May aes temas chat“ mie" Wo as ves Ns sa ale ela Ll ay ba They Se ae ge tse et Seema he 
Pe enc aie ee te eet ee I earn ae See SE bates ae 
et EOCTS) 
Pee ee EET 
'120(78) Filler 
emaaien ome pcre 
}124(7C) 


ey es eee oman are ame me 


Oe i 


Figure D-2 ATF Format for Signoff Account Record Type 
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10(0) Record type 12(2) Account Number H 
i (ATF .TYPE) i (ATF .ACCT) i 
: aa eeB Salat da sins ons as Sa nemesis” es Ss am ces ims ab Ys sas Sesh chan eens ies ls Sih ew als mS mee a rs Sema Pe ee a ce ect | 
14(4) Current date and time (ATF. ERT) i 
[en SS Shs Sales S SSeS SSS aS See SS See Sea Ser Tr RSS ae i 
18(8) 
(=Ssec5 User identification = ----- -4 
+12(C) (ATF .UID) H 
es eo ee Pe RO ae Se a ee ee eas STS ca H 
{16( 10) Job serial number (ATF.JOB) H 
a am a aa lag ll a H 
{20(14) Time task was started (ATF. SEAR 1 
Iti mero a a a a a a aN attra | 
}24(18) { 
ee SS i 
i28(1C) 
es es fd of task 2 2 2 2 2 2 2 2 2 FAH 
132(20) (ATF .TFD) | 
Poe EES ES 
1 36(24) 
{Sta e P eS SSS SSS Re Pee See SSeS a) SSCS Sesto SSS Steet sS > 1 
1 40(28) Account number 142( 2A) End of task code t 
H (ATF .ACT) i (ATF .RC) ! 
EST Sa er ee Ae ae RSS Sa ee tester Sees ea 
}44(2C) 
L=sese5 User-supplied information = ----~- i 
148(30) (ATF .USER) H 
[PAS SRS SoS Se SS eS SSS SSS SS SSS SSeS ae See SS ae eae Se i 
152(34) Impure segment 154(36) Pure segment size i 
\ sure (ATF.IMP) ' (ATF . PUR) ' 
LoS See Se SSSA SSeS SSS SST SSeS Se eee See a Se Sees sare Ste H 
56 (38) System space 158(3A) Roll count } 
f (ATF .SYS) 1 (ATF .ROLL) H 
[rest SSS SSS Ssh See Ss SSS Sass Se SSeS a eee eee ee SS- 545 | 
{60(3C) User CPU time (ATF .UCPU) H 
| Pa ee Soe eee SS See eA See ae Se Soe aS eee H 
164(40) SVC CPU time (ATF.SCPU) H 
[PSR SSS TSR SS eee Seas HS aS SSS sree See ae ere eee SSeS Seas i 
168(44) ROLL CPU time (ATF.RCPU) i 
aaa a me ala a a 
172(48) User APU time (ATF .UAPU) | 
a aN a aa lr a a i 
1 76(4C) Wait time (ATF .WTIM) H 
Poe pe ee ee ee eg ee i ea ee eS a eae i 
180(50) Roll queue time (ATF.RLTM) H 
he SSR SSeS Se Seas SS aS SS SS Sasa aS Se Sree Sree eae SS os | 
{84(54) Input/output (1/0) count for class O (ATF.IOCT) | 
[SDSS ERE OR ASS eS se sess e Serra Sse e es eR SSS seSs ase Sssesces H 
{88(58) Number of bytes Cranskerisd for class 0 H 
/ (ATF . IOXF ) ' 
fr rrr ' 
'92(5C) 1/O Count for class 1 H 
| aa on non nnn nnn ne ono ooo enn nnn nnn nn enn nnn nnn nnn nin 
ecco) Number of bytes transferred for class 1 H 
Looe eee a Se SS SSS Se See SS SSS STS SSS SSS SSeS St Se Sores tt H 
1100(64)_ 1/O Count for class 2 H 
(Seen ee eS SS SSeS eS SSS SSS sea Sera eS Resa TS SS Ts ' 
{104(68) Number of bytes epaneterred for class 2 | 
i Sas es cae es a eS is a a as ce ee is eee ec hte ee aes Sen ee ee { 
i 108(6C) I/O Count for class 3 H 
: ~— aoe en ee ee ewe Oe eee ew ewe ee we we wwe em we ee eee ee ew ee oe | 
{112(70) Number of bytes transferred for class 3 H 
' ee an a a a tare th ee Saeed dS Ts es, Ses eS ha Sle aa can et ar ew a tes Spe oa, ee eS | 
1116(74) 
boas see aaa ae | 
{120(70) Filler H 
besa SSS 
{124(7C) 
Figure D-3 ATF Format for Task Completion (ATYP.TSK) and 
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amy nee eee cme See ene me AES RD tee SD GE: mney GED MD mune meme Oe moe mm Gee ammo mune swe cm me mmm) sey OS wee cttee me een ere eee mm ee ne ne eee ee ee ee ee ee eee een 


0(0) Record type 12(2) Account. number 


; (ATF .TYPE) : (ATF .ACCT) } 
{ sa oa SE cae iti aa csc as as et cs Sn ttn) ly aie vig ToS Gc om Seen tas RS pate oe Sa se a Se es neh a te eS Sa ge ND So Nace ate a A ' 
14(4) Current date and time (ATF.CRTM) 1 
i~- i” eis tals <n * Sein” dad -joos ors i SN a ea els "tn * ate re? a Ses ‘adn n't ar oat iok atone ds cs ie a Sad eae ee eas ac sac asian tle emacs -——— aaa | 
18(8) We vane name ORT: VOL.) ; 
italia taariceeteealaten einen ieeeeiaatned aieniontantanteetententedentententantantenadinl ice ey ean iets ene gags pi ase Ail saa Wie law Theos Pas GR akan ~~ 
i12¢C) Filename (first Word) 1 
(ATF. alike 4 
; “s+ tts, ssi ims i Nets ios tip lc "aa ates tg. ii pet 5, We SSE. ae ceca Sn “igs iis i sia: eis ul a at: Satis “oes RR cc gk te: ay strats a eas heed oh ‘ 
{16(10) Mesdage pointer for SVC6 
CATES MSGP ) H 
i aie sn lng sss cin ew Sip <a wb wm ln sib) abo ee esi Sas ham Waban * Nah sme ib“ nse oe “ SS =iin“ohAS, ebwep’“laaebe.<ink> uun» San hath cab Sn, ean. coy inc ia Sah tae hee seo a H 
;20(14) Filename Gece eens i 
H aE: FNM2 ) 
H sala ie ct Sema ub uss emt cat \ sama me ass ema ose Tm foi Soa" fame sen fan a Vm eins Sc bot Sey =e” Cas oi’ Sabin ami Coase cot Sarma i) Grecia Sine car es a | 
i24(18) Extension H 
| arr nxt) \ 
| i in as i etna p> eas elas Acura eas, a Sa Sens rm" ease Sami eve “miu; Wis eis sel ice ak Sess 2 fous Sah mss isc es tase” Sia em ease a cin Gs Vlas vss es } 
+28(1C) Number of records i 
(ATF .RECS) 
\ siting vs in nin nes ‘espa et et) aes’ Site gan nb Ym a se ein“ ea ninth Sm seen” sasp “Anan "ia and Sona <b eet Sle: hte, sp sin can“ Sec Sik, a “van al a “ae ey H 
132(20) Humber of sectors 
} (ATE .SECS ) { 
' spl Aa smi. cs ese ss i shes << scaan Sedin*ssin.m So Rue, ‘Gg ~ “pnd Satna “eit Sle ae iad Spee Se ce a i hp <a gas och ai tir“: emda Ble ee sp a : 
1} 36(24) File creation date 
1 (ATF .CDAT) ' 
i ic a a et a ee Sa ha 4s ates cn aut bas <i, Cae ees a eel Sch sec ha anes vas sat Sms asl Temas sem toe aa “sy a a a Al a war as co Sy a ated at at i 
peu Gee? 
Seren sboe aaa New filename sige aise 
{44(2C) (ATF. NWEN) 
; pai Ret as alas we cn nf a, rpc em aa es Sata eh lac ag a te a Ns a cee a aa te, a als ng sates Late iba tessa aes He Sa aii fic tem cat WS : 
148(30) Extension 
Orr NWEX ) | 
aa ea aa a a ca a aa a a a alae 
'52(34) ReCoune number 54 (36) Filler 
oe NWAC ) i ! 
| — is once een. Sto cy nd eed cs Vibe, GR sa: ee Sasa” Se” hss Ss a es oS el ida pe ea Se aches gs cobs vay, Sl at yeas tn, rat i” oy: Sse < si ees a ch gO i a <n is ds se =| 
156 (38) ID of task v 
Fataecocgia that renamed file coe eaaiaaal 
'60(3C) Laie REID). 
H ecg a. Sea Siena ucla“ sles Sew Sc | Salsa ss es ah mf id ld a eas cea abi gin Vea ai ae “ay Ma eas aces is ate ple Sas Royce, ey nt S esawSai l ran ee H 
164(40) H 
Did cei Abe Se ae ae eects Al 
i 

ed Filler 


— a ene me ee — ee ee ee ee 


'124(7C) | 


eee re me cme cate meme mek se eee mem funn ms eee ms Mm fees ee em eee Mey re rt mem et te, Sim mie Oe meme mn mm cme Aen mires mem Se Mn es Ht me i ene me Me es ome, Ams Ate et, 


Figure D-4 ATF Format File Renaming Account Record Type 
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10(0) Record type 12(2) Account number } 
H (ATF. Tene) | (ATF .ACCT) H 
ariuaae cee ceaeenieugen aadnaessaaras a pemedauauencee 
14(4) Current date and eime (ATF .CRTM) H 
panei se hace lat ec aac owes cass mek ld SEI LEC 
18(8) Volume name (ATF .VOL) H 
SSS Se aS eee See See Se Seer eee eee H 
;12(C) Filename (first word) { 
H (ATF .FNAM) H 
lay orate ari an akg wes ama a Re ek a Ra aime | 
116(10) Message pointer for SVC6 | 
(ATF .MSGP ) ! 
{ fa ae sc Ss ee ier rem mse < Ss t iein ts eos > mnese >a ce Sesm ce ny easnsjemnt fices Tets escne ws mea ae M  “c ns cient | 
120(14) Filename (second word) H 
{ (ATF .FNM2 ) H 
i rin Sa ta Ste i, en “a a. atin ach a hn a Ss ai al“ es i a as CS eh ins tn, Sse Sms | 
124(18) Extension H 
{ (ATF .EXT) H 
l- fe et ease Stet cha Lae. asf al kt) ms hn a ee nl eee an chs ts, Se, cae "Cl at Seta aK i ts‘ es \ 
'28(1C) Number of records H 
H ATE. RECS) H 
' oe er fa ee inet ee: ky ees ek “en a imi ei en sm wi Yes mS en ie ns noms ios inn ei “Sl csc a | 
'32(20) Number of sectors H 
: (ATE .SECS ) H 
VSS ee PASS aieaigk ween Rhee en ere neree Sete t ares ee eae eases | 
'36(24) File creation date H 
' (ATF. CRAT).. H 
H Oh Se a oc a a a a a a Fe gs re eee Ss lees“ me leva. a ms iw Sv i gi cin ii i’ ees“ ' 
140(28) 
pS 
cae t2e) 
Laos => Filler Seana 
148(30) 
peace aaa 
S234) 
(ora aS ee SS SS ae eee ee ae ea sh a ea a 1 
156(38) ID Of task H 
eee that deleted file (422 7 ) meme H 
rOOGSe) (ATF .TKID) H 
: Ti) ie ty ak i, pals ae ea a fc," ie se lw asa. oe nn i eset me “nc i ui’ “a “Oe "a int‘ at mgs) cs ese" aee SHS is ee ed \ 
yeacs0) H 
dS aL 
Filler 
Tenn nnn i 
}124(7C) 
Figure D-5 ATF Format for File Deletion Account Record Type 
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APPENDIX E 
MULTI-TERMINAL MONITOR (MTM) OPERATOR COMMAND SUMMARY 


LOAD .MTM, fa 
TASK .MTM 
START ,AUF=fa [ATF-fd] [,TERMINAL-(fd, [fd,,...,fdg]) | 


[BATCH-(n,£d) |], PACE=fa] 


WAIT 
‘LERMI NAL 


STATUS, < BATCH 


USED [,fdi] 


TELL. 
userid message 
MESSAGE 
BROADCAST message 
device: 
.MTM ADD 
BATCH n[,fa] 


TERMINATE device: 


a 


REMOVE: 
lparcH n 


INQUIRE [fa | 
SUBMIT fd 
ATF fd 
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-MTM LLE 


-MTM PSM 


E-2 


muaorerniny| {ip 
N 


INTERVAL n 


1/Q n 
MAXPROCESSOR n 
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A 


Account Limit 
Account number 


Accounting data 
batch job 
task-related 
terminal session 
terminal user access 
Accounting facility 
system requirements 
Accounting times and formats 
elapsed time 
processor time 
processor time left 
roll CPU time 
signoff data and time 
signon time left 
SVC CPU time 
task elapsed time 
total processor time 
total task elapsed time 
user APU time 
user CPU time 
Accounting transaction 
files. See ATF. 
ACCOUNTS command 
ADD command 
ADD parameter 
Assistant task 
ATF 
-MTM command 
parameter 
AUF 
building and starting 
CREATE mode 
parameter 
REPORT mode 
START command 
UPDATE mode 
Authorized user file. See 
AUF . 
Authorized User Utility 
Authorized User Utility 
commands 
ACCOUNTS 
ADD 


CHANGE 


DELETE 


PRIVILEGE 
TOTAL 
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INDEX 


i | 
mew WO 
re 


BW edt 
No 


PPP Hb HP er HHL LS Ph hh PS - HW 
ee a a oe Pe Sbe oiles AB SD SI \ i 
5 Ph HhPHH HPS HOP S NrrPann 


WWWOWWWOWM SP OU WW 
iotopdo vod 
AaOnnNnon Penh Wome © 


B 
BATCH parameter 5-2 
-MTM ADD 5-5 
-MTM REMOVE 5-6 
MTM START command 5-2 


Batch processing 
PRC: limit 2-16 
BROADCAST parameter 5 


CDBUFS IZ 2 

CHANGE command 3 

Command buffers 2- 
2 


Command substitution system. 
See CSS. 
CONBFSZ 
Concurrent users 
per accounting user class 
Console buffers 


fot 


NW WPM NH NH ND Po 
I 
SEND OTe! pe AI WE ~~) 
Oo NO 


Count of I/0 transfers 
CREATE mode 


CSBFSZ - 
css 
levels 2-14 
D 
Data collection 4-1 
4-3 
Data structures 2-34 
Date and time submitted 4-6 
Date formats 4-3 
Default volume 2-20 
DELETE command 3-14 
Dynamic scheduling 2-24 
E 
Elapsed time 4-5 
END command 3-15 
End of task code 4-11 
5-11 
Error messages 6-13 
Error termination 6-4 
F 
File descriptor, task loaded . 
from 4-11 
File descriptors 1-3 
Forced roll 2-23 
IND~-1 


G MTM command 


| 
{ 
H format 5-4 
Global variables 2-27 '|  .|MTM command 
new global 2-28 3 examples a 
new internal 2-28 3} parameters 5=5 
{|  .MTM LLE commands 6-5 
{ CPU 6-6 
H DISPLAY 6-2 
. ! 6-6 
HASP interface 2-29 °! ELIGIBILITY 6-6 
' 6-7 
' 6-8 
I H examples 6~-8 
' LPU 6-6 
I/O H OFF - 6-6 
class table 2-8 ' 6-7 
control block 2-9 H ON 6-6 
Input/output. See I/0. ! 6-7 
INQUIRE parameter 5-7 i PSM 6-7 
Internal variables 2-13 |  .MTM LLE ELIGIBILITY 
2-28 | Gynamic queue 0 
IOTAB macro 2-8 H eligibility mode 6-7 
H fixed queue 0 
i eligibility mode 6-7 
J,K ' nooperation mode 6-7 
| .MTM PSM commands 6-5 
Job number 4-6 error messages 6-13 
4-11 } I/O 6-12 
i INTERNAL 6-12 
H MAXPROCESSOR 6-12 
L | MTM START command 5-2 
| MIM sysgen options 2-5 
LINK OPTION command 2-9 i batch job pause 2-20 
Link OPTION command 4-3 batch job PRC limit 2-16 
LINKOPT 2-9 { batch job priority 2-21 
LIST command 3-16 ! command buffer size 2-7 
LLE : console buffer size 227 
-MTM LLE command 6-6 ' default user volume 2-20 
APU task queue assignment 6-1 } forced roll 2-23 
control of MTM subtasks 6-7 \ global and local 
error messages 6-7 ' variables 2-27 
6-10 |! HASP interface 2-29 
operating tips 6-14 |! I/O class table 2-8 
Load-leveling executive. } I/O count limit per user 
See LLE. \ class 2-29 
Local variables 2-27 3} MTM link 2-9 
Logical unit 2=9 ‘ new global variables 2-28 
i new internal variables 2-28 
1 number of command buffers 2-12 
M | number of concurrent 
H users 2-16 
Memory requirements 2-34 } number of console buffers 2-10 
Memory used by a task 4-10 |; number of CSS levels 2-14 
Message buffers 2-14 |} number of message buffers 2-14 
MESSAGE parameter 5-5 ! number of sector length 
MODE command 3-19 | buffers 2-15 
MTM } O0S/32 accounting facility 2-19 
data structures 2-34 | PRC limit per user class 2-32 
description 1-1 : prompt device 2-17 
establishing accounts 3-1 H prompt sequence 2247 
link 22S ‘ scheduling 2-23 
operating procedures 5-1 ! sector buffer size 2-6 
operation in a Model : SPL/32 interface 2-27 
3200MPS System 6-1 H task queue size 2-19 
sysgen 2-1 ; version identification 2-33 
| MTMMAIN 2-1 
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-MTMMASST TASK 

MTMPARMS . MAC 

MTMSGN .CSS 

MTMSTRUC.MLB macro library 
Multi-terminal monitor. See 
MTM. 

Multiprocessing environment 


N 


NCONBFS 

NCSBFS 

NCSSLVS 

NMSGS 

NSECTS 

Number of commands entered 

Number of CSS calls executed 

Number of DISPLAY FILES 
commands 

Number of tasks executed 

NUSERS 


O 


Operating procedures 
end of task codes 
error message 
loading and establishing 
MTM 
MTM START command 
Operation of the LLE 
computat ion-intensive 
task 
CPU ready queue 
execution of MTM subtasks 
queue 0 
service-intensive task 
Optimization and control of 
load-leveling 
0S/32 accounting facility 


P 


PAGE parameter 
PAUSE command 
PRC time 
PRCLIMIT 

batch job 

I/O count limits 

job pause 

per user class 

relative default priority 
Prevention of CPU overload 
Priority scheduling 


dynamic 
Priority scheduling 
mechanism. See PSM. 


PRIVILEGE command 

Privileges 
account 
account 255 
default 

PRMTDEV macro 
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1 
WNHWNHNE a 


! 


' 
rPmHoOowUn 


Nh AMNMNN NH Pm Wom 
\ 


l 
N 
Ww 


we wee we we me we woe me wwe we ee we em ee me we ee ee em Se Om we oe ee me ee ee we we we ee ee 


PRMTSEQ macro 
Processor time Limit 
per account 
Program development feature 
Prompt device 
Prompt sequences 
PSM 


interval 
PURGE parameter 


QUES IZE 
Queue 0 eligibility 
algorithm 
fixed eligibility level 
QUIESCE parameter 


R 


REMOVE parameter 
Renamed and deleted files 
REPORT mode 


Reporting Utility 
Roll count 
Roll time 


Ss 


Secondary directory 

Sector buffer 

SGN. $HSP 

SGN. @GLO 

SGN. @INT 

SGN .ACT 

SGN .BTCP 

SGN .MVOL 

SGN.PRIO 

SGN. ROLL 

SGN.SPL 

SGN.VAR 

Signoff time 

Signon and signoff date and 

time 

Signon time limit 
per account 

SPL/32 interface 
new 

START command 
Authorized User Utility 
MTM 

STATUS parameter 

SUBMIT parameter 

Subtask scheduling 
dynamic 
priority 
PSM 

Subtasks of MTM 

Sysgen 


baal Eoaoetit 
Wa) ~J Ww ~J 


! 


OOM ON NNN WW bh 
od 
SWRP NH ee Pw 


H 


tot 


! 


PP PwwW AM 
f 
OEP RPAIMHIM 


IND-3 


MTM 
0S /32 


I 
PW Up NN Wh 


Neo 
j 


parameter file 
Sysgen options 
MTM 


0S /32 
SYSSTRUC.MLB macro library 
System generation. See 

sysgen. 
System requirements 


LS dll Sd ed 
| 


T 


Task counter overflow 
Task queue 
Task termination 


Wh 


1 
NWORPRP NOOO ef 


No 


TELL parameter 
TERMINAL parameter 
MTM START command 
Terminal prompt 
device name 
sequence 
TERMINATE parameter 
Time formats 
TOTAL command 


woul» & DM > 
! | } 


~s~ 


! 


WP ON Nb 
I 


oa) 


UIOLIM macro 
UPDATE mode 


| 
wo 


i 


PoP POD Ww Wh 
I 
Pon mw ~J oN 


UPRCLIM macro 
USED parameter 
User identifier 


No 


! 


re 


User-supplied information 


V 

Variables 

global 2-27 

local 2-27 
VERSION macro 2-33 

W,X,Y,2Z 

WAIT parameter 5-5 
Wait time 4-9 


cq 
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